Honeybee logo
Documentation Powered by ReDoc

Honeybee Model Schema (1.39.0)

Download OpenAPI specification:Download

Ladybug Tools: info@ladybug.tools URL: https://github.com/ladybug-tools/honeybee-schema License: BSD

This is the documentation for Honeybee model schema.

OpenAPI Specification with Inheritance

_AllAirBase

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
vintage
string (Vintages)
Enum: "90.1-2013" "90.1-2010" "90.1-2007" "90.1-2004" "DOE Ref 1980-2004" "DOE Ref Pre-1980"

An enumeration.

economizer_type
string (AllAirEconomizerType)
Enum: "Inferred" "NoEconomizer" "DifferentialDryBulb" "DifferentialEnthalpy"

An enumeration.

Autosize (object) or number (Sensible Heat Recovery)
Default: {"type":"Autosize"}

A number between 0 and 1 for the effectiveness of sensible heat recovery within the system. If None or Autosize, it will be whatever is recommended for the given vintage.

Autosize (object) or number (Latent Heat Recovery)
Default: {"type":"Autosize"}

A number between 0 and 1 for the effectiveness of latent heat recovery within the system. If None or Autosize, it will be whatever is recommended for the given vintage.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "_AllAirBase",
  • "vintage": "90.1-2013",
  • "economizer_type": "Inferred",
  • "sensible_heat_recovery":
    {
    },
  • "latent_heat_recovery":
    {
    }
}

_DOASBase

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
vintage
string (Vintages)
Enum: "90.1-2013" "90.1-2010" "90.1-2007" "90.1-2004" "DOE Ref 1980-2004" "DOE Ref Pre-1980"

An enumeration.

Autosize (object) or number (Sensible Heat Recovery)
Default: {"type":"Autosize"}

A number between 0 and 1 for the effectiveness of sensible heat recovery within the system. If None or Autosize, it will be whatever is recommended for the given vintage.

Autosize (object) or number (Latent Heat Recovery)
Default: {"type":"Autosize"}

A number between 0 and 1 for the effectiveness of latent heat recovery within the system. If None or Autosize, it will be whatever is recommended for the given vintage.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "_DOASBase",
  • "vintage": "90.1-2013",
  • "sensible_heat_recovery":
    {
    },
  • "latent_heat_recovery":
    {
    }
}

_EquipmentBase

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
watts_per_area
required
number <double> (Watts Per Area) >= 0

Equipment level per floor area as [W/m2].

schedule
required
string (Schedule) [ 1 .. 100 ] characters

Identifier of the schedule for the use of equipment over the course of the year. The type of this schedule should be Fractional and the fractional values will get multiplied by the watts_per_area to yield a complete equipment profile.

radiant_fraction
number <double> (Radiant Fraction) [ 0 .. 1 ]
Default: 0

Number for the amount of long-wave radiation heat given off by electric equipment. Default value is 0.

latent_fraction
number <double> (Latent Fraction) [ 0 .. 1 ]
Default: 0

Number for the amount of latent heat given off by electricequipment. Default value is 0.

lost_fraction
number <double> (Lost Fraction) [ 0 .. 1 ]
Default: 0

Number for the amount of “lost” heat being given off by equipment. The default value is 0.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "_EquipmentBase",
  • "watts_per_area": 0,
  • "schedule": "string",
  • "radiant_fraction": 0,
  • "latent_fraction": 0,
  • "lost_fraction": 0
}

_FaceSubSet

object (Interior Construction)

An OpaqueConstruction for walls with a Surface or Adiabatic boundary condition.

object (Exterior Construction)

An OpaqueConstruction for walls with an Outdoors boundary condition.

object (Ground Construction)

An OpaqueConstruction for walls with a Ground boundary condition.

type
string (Type) ^_FaceSubSet$
Default: "_FaceSubSet"
{
  • "interior_construction":
    {
    },
  • "exterior_construction":
    {
    },
  • "ground_construction":
    {
    },
  • "type": "_FaceSubSet"
}

_FaceSubSetAbridged

interior_construction
string (Interior Construction) [ 1 .. 100 ] characters

Identifier for an OpaqueConstruction for faces with a Surface or Adiabatic boundary condition.

exterior_construction
string (Exterior Construction) [ 1 .. 100 ] characters

Identifier for an OpaqueConstruction for faces with an Outdoors boundary condition.

ground_construction
string (Ground Construction) [ 1 .. 100 ] characters

Identifier for an OpaqueConstruction for faces with a Ground boundary condition.

type
string (Type) ^_FaceSubSetAbridged$
Default: "_FaceSubSetAbridged"
{
  • "interior_construction": "string",
  • "exterior_construction": "string",
  • "ground_construction": "string",
  • "type": "_FaceSubSetAbridged"
}

_HeatCoolBase

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
vintage
string (Vintages)
Enum: "90.1-2013" "90.1-2010" "90.1-2007" "90.1-2004" "DOE Ref 1980-2004" "DOE Ref Pre-1980"

An enumeration.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "_HeatCoolBase",
  • "vintage": "90.1-2013"
}

_PropertiesBaseAbridged

modifier
string (Modifier)

A string for a Honeybee Radiance Modifier (default: None).

modifier_blk
string (Modifier Blk)

A string for a Honeybee Radiance Modifier to be used in direct solar simulations and in isolation studies (assessingthe contribution of individual objects) (default: None).

type
string (Type) ^_PropertiesBaseAbridged$
Default: "_PropertiesBaseAbridged"
{
  • "modifier": "string",
  • "modifier_blk": "string",
  • "type": "_PropertiesBaseAbridged"
}

_RadianceAsset

identifier
required
string (Identifier)

Text string for a unique Radiance object. Must not contain spaces or special characters. This will be used to identify the object across a model and in the exported Radiance files.

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdRadianceBaseModel$
Default: "IDdRadianceBaseModel"
room_identifier
string (Room Identifier) [ 1 .. 100 ] characters [A-Za-z0-9_-]

Optional text string for the Room identifier to which this object belongs. This will be used to narrow down the number of aperture groups that have to be run with this sensor grid. If None, the grid will be run with all aperture groups in the model.

light_path
Array of Array of strings (Light Path)

Get or set a list of lists for the light path from the object to the sky. Each sub-list contains identifiers of aperture groups through which light passes. (eg. [["SouthWindow1"], ["static_apertures", "NorthWindow2"]]).Setting this property will override any auto-calculation of the light path from the model and room_identifier upon export to the simulation.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "_RadianceAsset",
  • "room_identifier": "string",
  • "light_path":
    [
    ]
}

_TemplateSystem

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
vintage
string (Vintages)
Enum: "90.1-2013" "90.1-2010" "90.1-2007" "90.1-2004" "DOE Ref 1980-2004" "DOE Ref Pre-1980"

An enumeration.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "_TemplateSystem",
  • "vintage": "90.1-2013"
}

Adiabatic

type
string (Type) ^Adiabatic$
Default: "Adiabatic"
{
  • "type": "Adiabatic"
}

AFNCrack

flow_coefficient
required
number <double> (Flow Coefficient)

A number in kg/s-m at 1 Pa per meter of crack length at the conditions defined in the ReferenceCrack condition; required to run an AirflowNetwork simulation. The DesignBuilder Cracks template defines the flow coefficient for a tight, low-leakage wall to be 0.00001 and 0.001 for external and internal constructions, respectively. Flow coefficients for a very poor, high-leakage wall are defined to be 0.0004 and 0.019 for external and internal constructions, respectively.

type
string (Type) ^AFNCrack$
Default: "AFNCrack"
flow_exponent
number <double> (Flow Exponent) [ 0.5 .. 1 ]
Default: 0.65

An optional dimensionless number between 0.5 and 1 used to calculate the crack mass flow rate; required to run an AirflowNetwork simulation. This value represents the leak geometry impact on airflow, with 0.5 generally corresponding to turbulent orifice flow and 1 generally corresponding to laminar flow. The default of 0.65 is representative of many cases of wall and window leakage, used when the exponent cannot be measured.

{
  • "flow_coefficient": 0,
  • "type": "AFNCrack",
  • "flow_exponent": 0.65
}

AirBoundaryConstruction

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
required
ScheduleRuleset (object) or ScheduleFixedInterval (object) (Air Mixing Schedule)

A fractional schedule as a ScheduleRuleset or ScheduleFixedInterval for the air mixing schedule across the construction.

air_mixing_per_area
number <double> (Air Mixing Per Area) >= 0
Default: 0.1

A positive number for the amount of air mixing between Rooms across the air boundary surface [m3/s-m2]. Default: 0.1 corresponds to average indoor air speeds of 0.1 m/s (roughly 20 fpm), which is typical of what would be induced by a HVAC system.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "AirBoundaryConstruction",
  • "air_mixing_schedule":
    {
    },
  • "air_mixing_per_area": 0.1
}

AirBoundaryConstructionAbridged

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
air_mixing_schedule
required
string (Air Mixing Schedule) [ 1 .. 100 ] characters

Identifier of a fractional schedule for the air mixing schedule across the construction.

air_mixing_per_area
number <double> (Air Mixing Per Area) >= 0
Default: 0.1

A positive number for the amount of air mixing between Rooms across the air boundary surface [m3/s-m2]. Default: 0.1 corresponds to average indoor air speeds of 0.1 m/s (roughly 20 fpm), which is typical of what would be induced by a HVAC system.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "AirBoundaryConstructionAbridged",
  • "air_mixing_schedule": "string",
  • "air_mixing_per_area": 0.1
}

AllAirEconomizerType

string (AllAirEconomizerType)
Enum: "Inferred" "NoEconomizer" "DifferentialDryBulb" "DifferentialEnthalpy"

An enumeration.

"Inferred"

Aperture

identifier
required
string (Identifier) [ 1 .. 100 ] characters [A-Za-z0-9_-]

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, rad). This identifier is also used to reference the object across a Model. It must be < 100 characters and not contain any spaces or special characters.

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

type
string ^IDdBaseModel$
Default: "IDdBaseModel"
required
object (Geometry)

Planar Face3D for the geometry.

required
Outdoors (object) or Surface (object) (Boundary Condition)
required
object (Properties)

Extension properties for particular simulation engines (Radiance, EnergyPlus).

is_operable
boolean (Is Operable)
Default: false

Boolean to note whether the Aperture can be opened for ventilation.

Array of objects (Indoor Shades)

Shades assigned to the interior side of this object (eg. window sill, light shelf).

Array of objects (Outdoor Shades)

Shades assigned to the exterior side of this object (eg. mullions, louvers).

{
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "type": "Aperture",
  • "geometry":
    {
    },
  • "boundary_condition":
    {
    },
  • "properties":
    {
    },
  • "is_operable": false,
  • "indoor_shades":
    [
    ],
  • "outdoor_shades":
    [
    ]
}

ApertureConstructionSet

type
string (Type) ^ApertureConstructionSet$
Default: "ApertureConstructionSet"
object (Interior Construction)

A WindowConstruction for apertures with an Outdoors boundary condition, False is_operable property, and a Wall face type for their parent face.

object (Window Construction)

A WindowConstruction for all apertures with a Surface boundary condition.

object (Skylight Construction)

A WindowConstruction for apertures with a Outdoors boundary condition, False is_operable property, and a RoofCeiling or Floor face type for their parent face.

object (Operable Construction)

A WindowConstruction for all apertures with an Outdoors boundary condition and True is_operable property.

{
  • "type": "ApertureConstructionSet",
  • "interior_construction":
    {
    },
  • "window_construction":
    {
    },
  • "skylight_construction":
    {
    },
  • "operable_construction":
    {
    }
}

ApertureConstructionSetAbridged

type
string (Type) ^ApertureConstructionSetAbridged$
Default: "ApertureConstructionSetAbridged"
interior_construction
string (Interior Construction) [ 1 .. 100 ] characters

Identifier for a WindowConstruction for apertures with an Outdoors boundary condition, False is_operable property, and a Wall face type for their parent face.

window_construction
string (Window Construction) [ 1 .. 100 ] characters

Identifier for a WindowConstruction for all apertures with a Surface boundary condition.

skylight_construction
string (Skylight Construction) [ 1 .. 100 ] characters

Identifier for a WindowConstruction for apertures with a Outdoors boundary condition, False is_operable property, and a RoofCeiling or Floor face type for their parent face.

operable_construction
string (Operable Construction) [ 1 .. 100 ] characters

Identifier for a WindowConstruction for all apertures with an Outdoors boundary condition and True is_operable property.

{
  • "type": "ApertureConstructionSetAbridged",
  • "interior_construction": "string",
  • "window_construction": "string",
  • "skylight_construction": "string",
  • "operable_construction": "string"
}

ApertureEnergyPropertiesAbridged

type
string (Type) ^ApertureEnergyPropertiesAbridged$
Default: "ApertureEnergyPropertiesAbridged"
construction
string (Construction) [ 1 .. 100 ] characters

Identifier of a WindowConstruction for the aperture. If None, the construction is set by the parent Room construction_set or the Model global_construction_set.

object (Vent Opening)

An optional VentilationOpening to specify the operable portion of the Aperture.

{
  • "type": "ApertureEnergyPropertiesAbridged",
  • "construction": "string",
  • "vent_opening":
    {
    }
}

ApertureModifierSet

type
string (Type) ^ApertureModifierSet$
Default: "ApertureModifierSet"
Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Window Modifier)

A modifier object for apertures with an Outdoors boundary condition, False is_operable property, and Wall parent Face.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Interior Modifier)

A modifier object for apertures with a Surface boundary condition.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Skylight Modifier)

A modifier object for apertures with an Outdoors boundary condition, False is_operable property, and a RoofCeiling or Floor face type for their parent face.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Operable Modifier)

A modifier object for apertures with an Outdoors boundary condition and a True is_operable property.

{
  • "type": "ApertureModifierSet",
  • "window_modifier":
    {
    },
  • "interior_modifier":
    {
    },
  • "skylight_modifier":
    {
    },
  • "operable_modifier":
    {
    }
}

ApertureModifierSetAbridged

type
string (Type) ^ApertureModifierSetAbridged$
Default: "ApertureModifierSetAbridged"
window_modifier
string (Window Modifier)

Identifier of modifier object for apertures with an Outdoors boundary condition, False is_operable property, and Wall parent Face.

interior_modifier
string (Interior Modifier)

Identifier of modifier object for apertures with a Surface boundary condition.

skylight_modifier
string (Skylight Modifier)

Identifier of modifier object for apertures with an Outdoors boundary condition, False is_operable property, and a RoofCeiling or Floor face type for their parent face.

operable_modifier
string (Operable Modifier)

Identifier of modifier object for apertures with an Outdoors boundary condition and a True is_operable property.

{
  • "type": "ApertureModifierSetAbridged",
  • "window_modifier": "string",
  • "interior_modifier": "string",
  • "skylight_modifier": "string",
  • "operable_modifier": "string"
}

AperturePropertiesAbridged

type
string (Type) ^AperturePropertiesAbridged$
Default: "AperturePropertiesAbridged"
object (ApertureEnergyPropertiesAbridged)

Base class for all objects that are not extensible with additional keys.

This effectively includes all objects except for the Properties classes that are assigned to geometry objects.

object (ApertureRadiancePropertiesAbridged)

Radiance Properties for Honeybee Aperture Abridged.

{
  • "type": "AperturePropertiesAbridged",
  • "energy":
    {
    },
  • "radiance":
    {
    }
}

ApertureRadiancePropertiesAbridged

modifier
string (Modifier)

A string for a Honeybee Radiance Modifier (default: None).

modifier_blk
string (Modifier Blk)

A string for a Honeybee Radiance Modifier to be used in direct solar simulations and in isolation studies (assessingthe contribution of individual objects) (default: None).

type
string ^_PropertiesBaseAbridged$
Default: "_PropertiesBaseAbridged"
dynamic_group_identifier
string (Dynamic Group Identifier)

An optional string to note the dynamic group ' 'to which the Aperture is a part of. Apertures sharing the same ' 'dynamic_group_identifier will have their states change in unison. ' 'If None, the Aperture is assumed to be static. (default: None).

Array of objects (States)

An optional list of abridged states (default: None).

{
  • "modifier": "string",
  • "modifier_blk": "string",
  • "type": "ApertureRadiancePropertiesAbridged",
  • "dynamic_group_identifier": "string",
  • "states":
    [
    ]
}

Autocalculate

type
string (Type) ^Autocalculate$
Default: "Autocalculate"
{
  • "type": "Autocalculate"
}

Autosize

type
string (Type) ^Autosize$
Default: "Autosize"
{
  • "type": "Autosize"
}

Baseboard

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
vintage
string (Vintages)
Enum: "90.1-2013" "90.1-2010" "90.1-2007" "90.1-2004" "DOE Ref 1980-2004" "DOE Ref Pre-1980"

An enumeration.

equipment_type
string (BaseboardEquipmentType)
Enum: "Baseboard electric" "Baseboard gas boiler" "Baseboard central air source heat pump" "Baseboard district hot water"

An enumeration.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "Baseboard",
  • "vintage": "90.1-2013",
  • "equipment_type": "Baseboard electric"
}

BaseboardEquipmentType

string (BaseboardEquipmentType)
Enum: "Baseboard electric" "Baseboard gas boiler" "Baseboard central air source heat pump" "Baseboard district hot water"

An enumeration.

"Baseboard electric"

BaseModifierSet

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Exterior Modifier)

A radiance modifier object for faces with an Outdoors boundary condition.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Interior Modifier)

A radiance modifier object for faces with a boundary condition other than Outdoors.

type
string (Type) ^BaseModifierSet$
Default: "BaseModifierSet"
{
  • "exterior_modifier":
    {
    },
  • "interior_modifier":
    {
    },
  • "type": "BaseModifierSet"
}

BaseModifierSetAbridged

exterior_modifier
string (Exterior Modifier)

Identifier for a radiance modifier object for faces with an Outdoors boundary condition.

interior_modifier
string (Interior Modifier)

Identifier for a radiance modifier object for faces with a boundary condition other than Outdoors.

type
string (Type) ^BaseModifierSetAbridged$
Default: "BaseModifierSetAbridged"
{
  • "exterior_modifier": "string",
  • "interior_modifier": "string",
  • "type": "BaseModifierSetAbridged"
}

BSDF

identifier
required
string (Identifier)

Text string for a unique Radiance object. Must not contain spaces or special characters. This will be used to identify the object across a model and in the exported Radiance files.

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdRadianceBaseModel$
Default: "IDdRadianceBaseModel"
bsdf_data
required
string (Bsdf Data)

A string with the contents of the BSDF XML file.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Modifier)
Default: {"type":"void"}

Material modifier (default: Void).

Array of Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Dependencies)

List of modifiers that this modifier depends on. This argument is only useful for defining advanced modifiers where the modifier is defined based on other modifiers (default: None).

up_orientation
Array of numbers <double> (Up Orientation) 3 items
Default: [0.01,0.01,1]

Vector as sequence that sets the hemisphere that the BSDF material faces. (default: (0.01, 0.01, 1.00).

thickness
number <double> (Thickness)
Default: 0

Optional number to set the thickness of the BSDF material Sign of thickness indicates whether proxied geometry is behind the BSDF surface (when thickness is positive) or in front (when thickness is negative)(default: 0).

function_file
string (Function File) [ 1 .. 100 ] characters
Default: "."

Optional input for function file (default: ".").

transform
string (Transform) [ 1 .. 100 ] characters

Optional transform input to scale the thickness and reorient the up vector (default: None).

front_diffuse_reflectance
Array of numbers <double> (Front Diffuse Reflectance) 3 items

Optional additional front diffuse reflectance as sequence of numbers (default: None).

back_diffuse_reflectance
Array of numbers <double> (Back Diffuse Reflectance) 3 items

Optional additional back diffuse reflectance as sequence of numbers (default: None).

diffuse_transmittance
Array of numbers <double> (Diffuse Transmittance) 3 items

Optional additional diffuse transmittance as sequence of numbers (default: None).

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "BSDF",
  • "bsdf_data": "string",
  • "modifier":
    {
    },
  • "dependencies":
    [
    ],
  • "up_orientation":
    [
    ],
  • "thickness": 0,
  • "function_file": ".",
  • "transform": "string",
  • "front_diffuse_reflectance":
    [
    ],
  • "back_diffuse_reflectance":
    [
    ],
  • "diffuse_transmittance":
    [
    ]
}

BuildingType

string (BuildingType)
Enum: "LowRise" "HighRise"

An enumeration.

"LowRise"

Color

r
required
integer <int32> (R) [ 0 .. 255 ]

Integer for red value.

g
required
integer <int32> (G) [ 0 .. 255 ]

Integer for green value.

b
required
integer <int32> (B) [ 0 .. 255 ]

Integer for blue value.

type
string (Type) ^Color$
Default: "Color"
{
  • "r": 0,
  • "g": 0,
  • "b": 0,
  • "type": "Color"
}

ConstructionSet

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
object (Wall Set)

A WallConstructionSet object for this ConstructionSet.

object (Floor Set)

A FloorConstructionSet object for this ConstructionSet.

object (Roof Ceiling Set)

A RoofCeilingConstructionSet object for this ConstructionSet.

object (Aperture Set)

A ApertureConstructionSet object for this ConstructionSet.

object (Door Set)

A DoorConstructionSet object for this ConstructionSet.

shade_construction
object (Shade Construction) Recursive

A ShadeConstruction to set the reflectance properties of all outdoor shades of all objects to which this ConstructionSet is assigned.

air_boundary_construction
object (Air Boundary Construction) Recursive

An AirBoundaryConstruction to set the properties of Faces with an AirBoundary type.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "ConstructionSet",
  • "wall_set":
    {
    },
  • "floor_set":
    {
    },
  • "roof_ceiling_set":
    {
    },
  • "aperture_set":
    {
    },
  • "door_set":
    {
    },
  • "shade_construction":
    {
    },
  • "air_boundary_construction":
    {
    }
}

ConstructionSetAbridged

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
object (Wall Set)

A WallConstructionSetAbridged object for this ConstructionSet.

object (Floor Set)

A FloorConstructionSetAbridged object for this ConstructionSet.

object (Roof Ceiling Set)

A RoofCeilingConstructionSetAbridged object for this ConstructionSet.

object (Aperture Set)

A ApertureConstructionSetAbridged object for this ConstructionSet.

object (Door Set)

A DoorConstructionSetAbridged object for this ConstructionSet.

shade_construction
string (Shade Construction) [ 1 .. 100 ] characters

The identifier of a ShadeConstruction to set the reflectance properties of all outdoor shades of all objects to which this ConstructionSet is assigned.

air_boundary_construction
string (Air Boundary Construction) [ 1 .. 100 ] characters

The identifier of an AirBoundaryConstruction to set the properties of Faces with an AirBoundary type.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "ConstructionSetAbridged",
  • "wall_set":
    {
    },
  • "floor_set":
    {
    },
  • "roof_ceiling_set":
    {
    },
  • "aperture_set":
    {
    },
  • "door_set":
    {
    },
  • "shade_construction": "string",
  • "air_boundary_construction": "string"
}

ControlType

string (ControlType)
Enum: "AlwaysOn" "OnIfHighSolarOnWindow" "OnIfHighHorizontalSolar" "OnIfHighOutdoorAirTemperature" "OnIfHighZoneAirTemperature" "OnIfHighZoneCooling" "OnNightIfLowOutdoorTempAndOffDay" "OnNightIfLowInsideTempAndOffDay" "OnNightIfHeatingAndOffDay"

Choices for how the shading device is controlled.

"AlwaysOn"

DatedBaseModel

type
string (Type) ^DatedBaseModel$
Default: "DatedBaseModel"
{
  • "type": "DatedBaseModel"
}

Door

identifier
required
string (Identifier) [ 1 .. 100 ] characters [A-Za-z0-9_-]

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, rad). This identifier is also used to reference the object across a Model. It must be < 100 characters and not contain any spaces or special characters.

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

type
string ^IDdBaseModel$
Default: "IDdBaseModel"
required
object (Geometry)

Planar Face3D for the geometry.

required
Outdoors (object) or Surface (object) (Boundary Condition)
required
object (Properties)

Extension properties for particular simulation engines (Radiance, EnergyPlus).

is_glass
boolean (Is Glass)
Default: false

Boolean to note whether this object is a glass door as opposed to an opaque door.

Array of objects (Indoor Shades)

Shades assigned to the interior side of this object.

Array of objects (Outdoor Shades)

Shades assigned to the exterior side of this object (eg. entryway awning).

{
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "type": "Door",
  • "geometry":
    {
    },
  • "boundary_condition":
    {
    },
  • "properties":
    {
    },
  • "is_glass": false,
  • "indoor_shades":
    [
    ],
  • "outdoor_shades":
    [
    ]
}

DoorConstructionSet

type
string (Type) ^DoorConstructionSet$
Default: "DoorConstructionSet"
object (Interior Construction)

An OpaqueConstruction for all opaque doors with a Surface boundary condition.

object (Exterior Construction)

An OpaqueConstruction for opaque doors with an Outdoors boundary condition and a Wall face type for their parent face.

object (Overhead Construction)

An OpaqueConstruction for opaque doors with an Outdoors boundary condition and a RoofCeiling or Floor type for their parent face.

object (Exterior Glass Construction)

A WindowConstruction for all glass doors with an Outdoors boundary condition.

object (Interior Glass Construction)

A WindowConstruction for all glass doors with a Surface boundary condition.

{
  • "type": "DoorConstructionSet",
  • "interior_construction":
    {
    },
  • "exterior_construction":
    {
    },
  • "overhead_construction":
    {
    },
  • "exterior_glass_construction":
    {
    },
  • "interior_glass_construction":
    {
    }
}

DoorConstructionSetAbridged

type
string (Type) ^DoorConstructionSetAbridged$
Default: "DoorConstructionSetAbridged"
interior_construction
string (Interior Construction) [ 1 .. 100 ] characters

Identifier for an OpaqueConstruction for all opaque doors with a Surface boundary condition.

exterior_construction
string (Exterior Construction) [ 1 .. 100 ] characters

Identifier for an OpaqueConstruction for opaque doors with an Outdoors boundary condition and a Wall face type for their parent face.

overhead_construction
string (Overhead Construction) [ 1 .. 100 ] characters

Identifier for an OpaqueConstruction for opaque doors with an Outdoors boundary condition and a RoofCeiling or Floor type for their parent face.

exterior_glass_construction
string (Exterior Glass Construction) [ 1 .. 100 ] characters

Identifier for a WindowConstruction for all glass doors with an Outdoors boundary condition.

interior_glass_construction
string (Interior Glass Construction) [ 1 .. 100 ] characters

Identifier for a WindowConstruction for all glass doors with a Surface boundary condition.

{
  • "type": "DoorConstructionSetAbridged",
  • "interior_construction": "string",
  • "exterior_construction": "string",
  • "overhead_construction": "string",
  • "exterior_glass_construction": "string",
  • "interior_glass_construction": "string"
}

DoorEnergyPropertiesAbridged

type
string (Type) ^DoorEnergyPropertiesAbridged$
Default: "DoorEnergyPropertiesAbridged"
construction
string (Construction) [ 1 .. 100 ] characters

Identifier of an OpaqueConstruction or WindowConstruction for the door. Note that the host door must have the is_glass property set to True to assign a WindowConstruction. If None, the construction is set by the parent Room construction_set or the Model global_construction_set.

object (Vent Opening)

An optional VentilationOpening to specify the operable portion of the Door.

{
  • "type": "DoorEnergyPropertiesAbridged",
  • "construction": "string",
  • "vent_opening":
    {
    }
}

DoorModifierSet

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Exterior Modifier)

A radiance modifier object for faces with an Outdoors boundary condition.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Interior Modifier)

A radiance modifier object for faces with a boundary condition other than Outdoors.

type
string (Type) ^DoorModifierSet$
Default: "DoorModifierSet"
Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Interior Glass Modifier)

A modifier object for glass with a Surface boundary condition.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Exterior Glass Modifier)

A modifier object for glass with an Outdoors boundary condition.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Overhead Modifier)

A window modifier object for doors with an Outdoors boundary condition and a RoofCeiling or Floor face type for their parent face.

{
  • "exterior_modifier":
    {
    },
  • "interior_modifier":
    {
    },
  • "type": "DoorModifierSet",
  • "interior_glass_modifier":
    {
    },
  • "exterior_glass_modifier":
    {
    },
  • "overhead_modifier":
    {
    }
}

DoorModifierSetAbridged

exterior_modifier
string (Exterior Modifier)

Identifier for a radiance modifier object for faces with an Outdoors boundary condition.

interior_modifier
string (Interior Modifier)

Identifier for a radiance modifier object for faces with a boundary condition other than Outdoors.

type
string ^BaseModifierSetAbridged$
Default: "BaseModifierSetAbridged"
interior_glass_modifier
string (Interior Glass Modifier)

Identifier of modifier object for glass with a Surface boundary condition.

exterior_glass_modifier
string (Exterior Glass Modifier)

Identifier of modifier object for glass with an Outdoors boundary condition.

overhead_modifier
string (Overhead Modifier)

Identifier of a modifier object for doors with an Outdoors boundary condition and a RoofCeiling or Floor face type for their parent face.

{
  • "exterior_modifier": "string",
  • "interior_modifier": "string",
  • "type": "DoorModifierSetAbridged",
  • "interior_glass_modifier": "string",
  • "exterior_glass_modifier": "string",
  • "overhead_modifier": "string"
}

DoorPropertiesAbridged

type
string (Type) ^DoorPropertiesAbridged$
Default: "DoorPropertiesAbridged"
object (DoorEnergyPropertiesAbridged)

Base class for all objects that are not extensible with additional keys.

This effectively includes all objects except for the Properties classes that are assigned to geometry objects.

object (DoorRadiancePropertiesAbridged)

Radiance Properties for Honeybee Door Abridged.

{
  • "type": "DoorPropertiesAbridged",
  • "energy":
    {
    },
  • "radiance":
    {
    }
}

DoorRadiancePropertiesAbridged

modifier
string (Modifier)

A string for a Honeybee Radiance Modifier (default: None).

modifier_blk
string (Modifier Blk)

A string for a Honeybee Radiance Modifier to be used in direct solar simulations and in isolation studies (assessingthe contribution of individual objects) (default: None).

type
string ^_PropertiesBaseAbridged$
Default: "_PropertiesBaseAbridged"
dynamic_group_identifier
string (Dynamic Group Identifier)

An optional string to note the dynamic group ' 'to which the Door is a part of. Doors sharing the same ' 'dynamic_group_identifier will have their states change in unison. ' 'If None, the Door is assumed to be static. (default: None).

Array of objects (States)

An optional list of abridged states (default: None).

{
  • "modifier": "string",
  • "modifier_blk": "string",
  • "type": "DoorRadiancePropertiesAbridged",
  • "dynamic_group_identifier": "string",
  • "states":
    [
    ]
}

EconomizerType

string (EconomizerType)
Enum: "NoEconomizer" "DifferentialDryBulb" "DifferentialEnthalpy"

An enumeration.

"NoEconomizer"

ElectricEquipment

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
watts_per_area
required
number <double> (Watts Per Area) >= 0

Equipment level per floor area as [W/m2].

required
ScheduleRuleset (object) or ScheduleFixedInterval (object) (Schedule)

The schedule for the use of equipment over the course of the year. The type of this schedule should be Fractional and the fractional values will get multiplied by the watts_per_area to yield a complete equipment profile.

radiant_fraction
number <double> (Radiant Fraction) [ 0 .. 1 ]
Default: 0

Number for the amount of long-wave radiation heat given off by electric equipment. Default value is 0.

latent_fraction
number <double> (Latent Fraction) [ 0 .. 1 ]
Default: 0

Number for the amount of latent heat given off by electricequipment. Default value is 0.

lost_fraction
number <double> (Lost Fraction) [ 0 .. 1 ]
Default: 0

Number for the amount of “lost” heat being given off by equipment. The default value is 0.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "ElectricEquipment",
  • "watts_per_area": 0,
  • "schedule":
    {
    },
  • "radiant_fraction": 0,
  • "latent_fraction": 0,
  • "lost_fraction": 0
}

ElectricEquipmentAbridged

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
watts_per_area
required
number <double> (Watts Per Area) >= 0

Equipment level per floor area as [W/m2].

schedule
required
string (Schedule) [ 1 .. 100 ] characters

Identifier of the schedule for the use of equipment over the course of the year. The type of this schedule should be Fractional and the fractional values will get multiplied by the watts_per_area to yield a complete equipment profile.

radiant_fraction
number <double> (Radiant Fraction) [ 0 .. 1 ]
Default: 0

Number for the amount of long-wave radiation heat given off by electric equipment. Default value is 0.

latent_fraction
number <double> (Latent Fraction) [ 0 .. 1 ]
Default: 0

Number for the amount of latent heat given off by electricequipment. Default value is 0.

lost_fraction
number <double> (Lost Fraction) [ 0 .. 1 ]
Default: 0

Number for the amount of “lost” heat being given off by equipment. The default value is 0.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "ElectricEquipmentAbridged",
  • "watts_per_area": 0,
  • "schedule": "string",
  • "radiant_fraction": 0,
  • "latent_fraction": 0,
  • "lost_fraction": 0
}

EnergyMaterial

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
thickness
required
number <double> (Thickness) <= 3

Thickness of the material layer in meters.

conductivity
required
number <double> (Conductivity)

Thermal conductivity of the material layer in W/(m-K).

density
required
number <double> (Density)

Density of the material layer in kg/m3.

specific_heat
required
number <double> (Specific Heat) >= 100

Specific heat of the material layer in J/(kg-K).

roughness
string (Roughness)
Enum: "VeryRough" "Rough" "MediumRough" "MediumSmooth" "Smooth" "VerySmooth"

Relative roughness of a particular material layer.

thermal_absorptance
number <double> (Thermal Absorptance) <= 0.99999
Default: 0.9

Fraction of incident long wavelength radiation that is absorbed by the material. Default value is 0.9.

solar_absorptance
number <double> (Solar Absorptance) [ 0 .. 1 ]
Default: 0.7

Fraction of incident solar radiation absorbed by the material. Default value is 0.7.

visible_absorptance
number <double> (Visible Absorptance) [ 0 .. 1 ]
Default: 0.7

Fraction of incident visible wavelength radiation absorbed by the material. Default value is 0.7.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "EnergyMaterial",
  • "thickness": 0,
  • "conductivity": 0,
  • "density": 0,
  • "specific_heat": 100,
  • "roughness": "VeryRough",
  • "thermal_absorptance": 0.9,
  • "solar_absorptance": 0.7,
  • "visible_absorptance": 0.7
}

EnergyMaterialNoMass

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
r_value
required
number <double> (R Value) >= 0.001

The thermal resistance (R-value) of the material layer [m2-K/W].

roughness
string (Roughness)
Enum: "VeryRough" "Rough" "MediumRough" "MediumSmooth" "Smooth" "VerySmooth"

Relative roughness of a particular material layer.

thermal_absorptance
number <double> (Thermal Absorptance) <= 0.99999
Default: 0.9

Fraction of incident long wavelength radiation that is absorbed by the material. Default value is 0.9.

solar_absorptance
number <double> (Solar Absorptance) [ 0 .. 1 ]
Default: 0.7

Fraction of incident solar radiation absorbed by the material. Default value is 0.7.

visible_absorptance
number <double> (Visible Absorptance) [ 0 .. 1 ]
Default: 0.7

Fraction of incident visible wavelength radiation absorbed by the material. Default value is 0.7.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "EnergyMaterialNoMass",
  • "r_value": 0.001,
  • "roughness": "VeryRough",
  • "thermal_absorptance": 0.9,
  • "solar_absorptance": 0.7,
  • "visible_absorptance": 0.7
}

EnergyWindowMaterialBlind

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
slat_orientation
string (SlatOrientation)
Enum: "Horizontal" "Vertical"

An enumeration.

slat_width
number <double> (Slat Width) <= 1
Default: 0.025

The width of slat measured from edge to edge in meters.

slat_separation
number <double> (Slat Separation) <= 1
Default: 0.01875

The distance between the front of a slat and the back of the adjacent slat in meters.

slat_thickness
number <double> (Slat Thickness) <= 0.1
Default: 0.001

The distance between the faces of a slat in meters. The default value is 0.001.

slat_angle
number <double> (Slat Angle) [ 0 .. 180 ]
Default: 45

The angle (degrees) between the glazing outward normal and the slat outward normal where the outward normal points away from the front face of the slat (degrees). The default value is 45.

slat_conductivity
number <double> (Slat Conductivity)
Default: 221

The thermal conductivity of the slat in W/(m-K). Default value is 221.

beam_solar_transmittance
number <double> (Beam Solar Transmittance) >= 0
Default: 0

The beam solar transmittance of the slat, assumed to be independent of angle of incidence on the slat. Any transmitted beam radiation is assumed to be 100% diffuse (i.e., slats are translucent). The default value is 0.

beam_solar_reflectance
number <double> (Beam Solar Reflectance) >= 0
Default: 0.5

The beam solar reflectance of the front side of the slat, it is assumed to be independent of the angle of incidence. Default value is 0.5.

beam_solar_reflectance_back
number <double> (Beam Solar Reflectance Back) >= 0
Default: 0.5

The beam solar reflectance of the back side of the slat, it is assumed to be independent of the angle of incidence. Default value is 0.5.

diffuse_solar_transmittance
number <double> (Diffuse Solar Transmittance) >= 0
Default: 0

The slat transmittance for hemisperically diffuse solar radiation. Default value is 0.

diffuse_solar_reflectance
number <double> (Diffuse Solar Reflectance) >= 0
Default: 0.5

The front-side slat reflectance for hemispherically diffuse solar radiation. Default value is 0.5.

diffuse_solar_reflectance_back
number <double> (Diffuse Solar Reflectance Back) >= 0
Default: 0.5

The back-side slat reflectance for hemispherically diffuse solar radiation. Default value is 0.5.

beam_visible_transmittance
number <double> (Beam Visible Transmittance) >= 0
Default: 0

The beam visible transmittance of the slat, it is assumed to be independent of the angle of incidence. Default value is 0.

beam_visible_reflectance
number <double> (Beam Visible Reflectance) >= 0
Default: 0.5

The beam visible reflectance on the front side of the slat, it is assumed to be independent of the angle of incidence. Default value is 0.5.

beam_visible_reflectance_back
number <double> (Beam Visible Reflectance Back) >= 0
Default: 0.5

The beam visible reflectance on the back side of the slat, it is assumed to be independent of the angle of incidence. Default value is 0.5.

diffuse_visible_transmittance
number <double> (Diffuse Visible Transmittance) >= 0
Default: 0

The slat transmittance for hemispherically diffuse visible radiation. This value should equal “Slat Beam Visible Transmittance.”

diffuse_visible_reflectance
number <double> (Diffuse Visible Reflectance) >= 0
Default: 0.5

The front-side slat reflectance for hemispherically diffuse visible radiation. This value should equal “Front Side Slat Beam Visible Reflectance.” Default value is 0.5.

diffuse_visible_reflectance_back
number <double> (Diffuse Visible Reflectance Back) >= 0
Default: 0.5

The back-side slat reflectance for hemispherically diffuse visible radiation. This value should equal “Back Side Slat Beam Visible Reflectance. Default value is 0.5.”

infrared_transmittance
number <double> (Infrared Transmittance) >= 0
Default: 0

The slat infrared hemispherical transmittance. It is zero for solid metallic, wooden or glass slats, but may be non-zero in some cases such as for thin plastic slats. The default value is 0.

emissivity
number <double> (Emissivity) >= 0
Default: 0.9

Front side hemispherical emissivity of the slat. Default is 0.9 for most materials. The default value is 0.9.

emissivity_back
number <double> (Emissivity Back) >= 0
Default: 0.9

Back side hemispherical emissivity of the slat. Default is 0.9 for most materials. The default value is 0.9.

distance_to_glass
number <double> (Distance To Glass) [ 0.01 .. 1 ]
Default: 0.05

The distance from the mid-plane of the blind to the adjacent glass in meters. The default value is 0.05.

top_opening_multiplier
number <double> (Top Opening Multiplier) [ 0 .. 1 ]
Default: 0.5

The effective area for air flow at the top of the shade, divided by the horizontal area between glass and shade. The default value is 0.5

bottom_opening_multiplier
number <double> (Bottom Opening Multiplier) [ 0 .. 1 ]
Default: 0.5

The effective area for air flow at the bottom of the shade, divided by the horizontal area between glass and shade. The default value is 0.

left_opening_multiplier
number <double> (Left Opening Multiplier) [ 0 .. 1 ]
Default: 0.5

The effective area for air flow at the left side of the shade, divided by the vertical area between glass and shade. The default value is 0.5.

right_opening_multiplier
number <double> (Right Opening Multiplier) [ 0 .. 1 ]
Default: 0.5

The effective area for air flow at the right side of the shade, divided by the vertical area between glass and shade. The default value is 0.5.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "EnergyWindowMaterialBlind",
  • "slat_orientation": "Horizontal",
  • "slat_width": 0.025,
  • "slat_separation": 0.01875,
  • "slat_thickness": 0.001,
  • "slat_angle": 45,
  • "slat_conductivity": 221,
  • "beam_solar_transmittance": 0,
  • "beam_solar_reflectance": 0.5,
  • "beam_solar_reflectance_back": 0.5,
  • "diffuse_solar_transmittance": 0,
  • "diffuse_solar_reflectance": 0.5,
  • "diffuse_solar_reflectance_back": 0.5,
  • "beam_visible_transmittance": 0,
  • "beam_visible_reflectance": 0.5,
  • "beam_visible_reflectance_back": 0.5,
  • "diffuse_visible_transmittance": 0,
  • "diffuse_visible_reflectance": 0.5,
  • "diffuse_visible_reflectance_back": 0.5,
  • "infrared_transmittance": 0,
  • "emissivity": 0.9,
  • "emissivity_back": 0.9,
  • "distance_to_glass": 0.05,
  • "top_opening_multiplier": 0.5,
  • "bottom_opening_multiplier": 0.5,
  • "left_opening_multiplier": 0.5,
  • "right_opening_multiplier": 0.5
}

EnergyWindowMaterialGas

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
thickness
number <double> (Thickness)
Default: 0.0125

Thickness of the gas layer in meters. Default value is 0.0125.

gas_type
string (GasType)
Enum: "Air" "Argon" "Krypton" "Xenon"

An enumeration.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "EnergyWindowMaterialGas",
  • "thickness": 0.0125,
  • "gas_type": "Air"
}

EnergyWindowMaterialGasCustom

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
conductivity_coeff_a
required
number <double> (Conductivity Coeff A)

The A coefficient for gas conductivity in W/(m-K).

viscosity_coeff_a
required
number <double> (Viscosity Coeff A)

The A coefficient for gas viscosity in kg/(m-s).

specific_heat_coeff_a
required
number <double> (Specific Heat Coeff A)

The A coefficient for gas specific heat in J/(kg-K).

specific_heat_ratio
required
number <double> (Specific Heat Ratio)

The specific heat ratio for gas.

molecular_weight
required
number <double> (Molecular Weight) [ 20 .. 200 ]

The molecular weight for gas in g/mol.

thickness
number <double> (Thickness)
Default: 0.0125

Thickness of the gas layer in meters. Default value is 0.0125.

conductivity_coeff_b
number <double> (Conductivity Coeff B)
Default: 0

The B coefficient for gas conductivity in W/(m-K2).

conductivity_coeff_c
number <double> (Conductivity Coeff C)
Default: 0

The C coefficient for gas conductivity in W/(m-K3).

viscosity_coeff_b
number <double> (Viscosity Coeff B)
Default: 0

The B coefficient for gas viscosity in kg/(m-s-K).

viscosity_coeff_c
number <double> (Viscosity Coeff C)
Default: 0

The C coefficient for gas viscosity in kg/(m-s-K2).

specific_heat_coeff_b
number <double> (Specific Heat Coeff B)
Default: 0

The B coefficient for gas specific heat in J/(kg-K2).

specific_heat_coeff_c
number <double> (Specific Heat Coeff C)
Default: 0

The C coefficient for gas specific heat in J/(kg-K3).

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "EnergyWindowMaterialGasCustom",
  • "conductivity_coeff_a": 0,
  • "viscosity_coeff_a": 0,
  • "specific_heat_coeff_a": 0,
  • "specific_heat_ratio": 0,
  • "molecular_weight": 20,
  • "thickness": 0.0125,
  • "conductivity_coeff_b": 0,
  • "conductivity_coeff_c": 0,
  • "viscosity_coeff_b": 0,
  • "viscosity_coeff_c": 0,
  • "specific_heat_coeff_b": 0,
  • "specific_heat_coeff_c": 0
}

EnergyWindowMaterialGasMixture

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
gas_types
required
Array of strings (Gas Types) [ 2 .. 4 ] items
Items Enum: "Air" "Argon" "Krypton" "Xenon"

List of gases in the gas mixture.

gas_fractions
required
Array of numbers <double> (Gas Fractions) [ 2 .. 4 ] items

A list of fractional numbers describing the volumetric fractions of gas types in the mixture. This list must align with the gas_types list and must sum to 1.

thickness
number <double> (Thickness)
Default: 0.0125

The thickness of the gas mixture layer in meters.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "EnergyWindowMaterialGasMixture",
  • "gas_types":
    [
    ],
  • "gas_fractions":
    [
    ],
  • "thickness": 0.0125
}

EnergyWindowMaterialGlazing

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
thickness
number <double> (Thickness)
Default: 0.003

The surface-to-surface of the glass in meters. Default value is 0.003.

solar_transmittance
number <double> (Solar Transmittance) [ 0 .. 1 ]
Default: 0.85

Transmittance of solar radiation through the glass at normal incidence. Default value is 0.85 for clear glass.

solar_reflectance
number <double> (Solar Reflectance) [ 0 .. 1 ]
Default: 0.075

Reflectance of solar radiation off of the front side of the glass at normal incidence, averaged over the solar spectrum. Default value is 0.075 for clear glass.

solar_reflectance_back
number <double> (Solar Reflectance Back)

Reflectance of solar radiation off of the back side of the glass at normal incidence, averaged over the solar spectrum.

visible_transmittance
number <double> (Visible Transmittance) [ 0 .. 1 ]
Default: 0.9

Transmittance of visible light through the glass at normal incidence. Default value is 0.9 for clear glass.

visible_reflectance
number <double> (Visible Reflectance) [ 0 .. 1 ]
Default: 0.075

Reflectance of visible light off of the front side of the glass at normal incidence. Default value is 0.075 for clear glass.

visible_reflectance_back
number <double> (Visible Reflectance Back) [ 0 .. 1 ]

Reflectance of visible light off of the back side of the glass at normal incidence averaged over the solar spectrum and weighted by the response of the human eye.

infrared_transmittance
number <double> (Infrared Transmittance) [ 0 .. 1 ]
Default: 0

Long-wave transmittance at normal incidence.

emissivity
number <double> (Emissivity) [ 0 .. 1 ]
Default: 0.84

Infrared hemispherical emissivity of the front (outward facing) side of the glass. Default value is 0.84, which is typical for clear glass without a low-e coating.

emissivity_back
number <double> (Emissivity Back) [ 0 .. 1 ]
Default: 0.84

Infrared hemispherical emissivity of the back (inward facing) side of the glass. Default value is 0.84, which is typical for clear glass without a low-e coating.

conductivity
number <double> (Conductivity)
Default: 0.9

Thermal conductivity of the glass in W/(m-K). Default value is 0.9, which is typical for clear glass without a low-e coating.

dirt_correction
number <double> (Dirt Correction)
Default: 1

Factor that corrects for the presence of dirt on the glass. A default value of 1 indicates the glass is clean.

solar_diffusing
boolean (Solar Diffusing)
Default: false

Takes values True and False. If False (default), the beam solar radiation incident on the glass is transmitted as beam radiation with no diffuse component.If True, the beam solar radiation incident on the glass is transmitted as hemispherical diffuse radiation with no beam component.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "EnergyWindowMaterialGlazing",
  • "thickness": 0.003,
  • "solar_transmittance": 0.85,
  • "solar_reflectance": 0.075,
  • "solar_reflectance_back": 0,
  • "visible_transmittance": 0.9,
  • "visible_reflectance": 0.075,
  • "visible_reflectance_back": 0,
  • "infrared_transmittance": 0,
  • "emissivity": 0.84,
  • "emissivity_back": 0.84,
  • "conductivity": 0.9,
  • "dirt_correction": 1,
  • "solar_diffusing": false
}

EnergyWindowMaterialShade

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
solar_transmittance
number <double> (Solar Transmittance) >= 0
Default: 0.4

The transmittance averaged over the solar spectrum. It is assumed independent of incidence angle. Default value is 0.4.

solar_reflectance
number <double> (Solar Reflectance) >= 0
Default: 0.5

The reflectance averaged over the solar spectrum. It us assumed same on both sides of shade and independent of incidence angle. Default value is 0.5

visible_transmittance
number <double> (Visible Transmittance) >= 0
Default: 0.4

The transmittance averaged over the solar spectrum and weighted by the response of the human eye. It is assumed independent of incidence angle. Default value is 0.4.

visible_reflectance
number <double> (Visible Reflectance) >= 0
Default: 0.4

The transmittance averaged over the solar spectrum and weighted by the response of the human eye. It is assumed independent of incidence angle. Default value is 0.4

emissivity
number <double> (Emissivity)
Default: 0.9

The effective long-wave infrared hemispherical emissivity. It is assumed same on both sides of shade. Default value is 0.9.

infrared_transmittance
number <double> (Infrared Transmittance) >= 0
Default: 0

The effective long-wave transmittance. It is assumed independent of incidence angle. Default value is 0.

thickness
number <double> (Thickness)
Default: 0.005

The thickness of the shade material in meters. Default value is 0.005.

conductivity
number <double> (Conductivity)
Default: 0.1

The conductivity of the shade material in W/(m-K). Default value is 0.1.

distance_to_glass
number <double> (Distance To Glass) [ 0.001 .. 1 ]
Default: 0.05

The distance from shade to adjacent glass in meters. Default value is 0.05

top_opening_multiplier
number <double> (Top Opening Multiplier) [ 0 .. 1 ]
Default: 0.5

The effective area for air flow at the top of the shade, divided by the horizontal area between glass and shade. Default value is 0.5.

bottom_opening_multiplier
number <double> (Bottom Opening Multiplier) [ 0 .. 1 ]
Default: 0.5

The effective area for air flow at the bottom of the shade, divided by the horizontal area between glass and shade. Default value is 0.5.

left_opening_multiplier
number <double> (Left Opening Multiplier) [ 0 .. 1 ]
Default: 0.5

The effective area for air flow at the left side of the shade, divided by the vertical area between glass and shade. Default value is 0.5.

right_opening_multiplier
number <double> (Right Opening Multiplier) [ 0 .. 1 ]
Default: 0.5

The effective area for air flow at the right side of the shade, divided by the vertical area between glass and shade. Default value is 0.5.

airflow_permeability
number <double> (Airflow Permeability) [ 0 .. 0.8 ]
Default: 0

The fraction of the shade surface that is open to air flow. If air cannot pass through the shade material, airflow_permeability = 0. Default value is 0.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "EnergyWindowMaterialShade",
  • "solar_transmittance": 0.4,
  • "solar_reflectance": 0.5,
  • "visible_transmittance": 0.4,
  • "visible_reflectance": 0.4,
  • "emissivity": 0.9,
  • "infrared_transmittance": 0,
  • "thickness": 0.005,
  • "conductivity": 0.1,
  • "distance_to_glass": 0.05,
  • "top_opening_multiplier": 0.5,
  • "bottom_opening_multiplier": 0.5,
  • "left_opening_multiplier": 0.5,
  • "right_opening_multiplier": 0.5,
  • "airflow_permeability": 0
}

EnergyWindowMaterialSimpleGlazSys

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
u_factor
required
number <double> (U Factor) <= 5.8

Used to describe the value for window system U-Factor, or overall heat transfer coefficient in W/(m2-K).

shgc
required
number <double> (Shgc)

Unitless quantity describing Solar Heat Gain Coefficient for normal incidence and vertical orientation.

vt
number <double> (Vt)
Default: 0.54

The fraction of visible light falling on the window that makes it through the glass at normal incidence.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "EnergyWindowMaterialSimpleGlazSys",
  • "u_factor": 0,
  • "shgc": 0,
  • "vt": 0.54
}

EvaporativeCooler

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
vintage
string (Vintages)
Enum: "90.1-2013" "90.1-2010" "90.1-2007" "90.1-2004" "DOE Ref 1980-2004" "DOE Ref Pre-1980"

An enumeration.

equipment_type
string (EvaporativeCoolerEquipmentType)
Enum: "Direct evap coolers with baseboard electric" "Direct evap coolers with baseboard gas boiler" "Direct evap coolers with baseboard central air source heat pump" "Direct evap coolers with baseboard district hot water" "Direct evap coolers with forced air furnace" "Direct evap coolers with gas unit heaters" "Direct evap coolers with no heat"

An enumeration.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "EvaporativeCooler",
  • "vintage": "90.1-2013",
  • "equipment_type": "Direct evap coolers with baseboard electric"
}

EvaporativeCoolerEquipmentType

string (EvaporativeCoolerEquipmentType)
Enum: "Direct evap coolers with baseboard electric" "Direct evap coolers with baseboard gas boiler" "Direct evap coolers with baseboard central air source heat pump" "Direct evap coolers with baseboard district hot water" "Direct evap coolers with forced air furnace" "Direct evap coolers with gas unit heaters" "Direct evap coolers with no heat"

An enumeration.

"Direct evap coolers with baseboard electric"

Face3D

boundary
required
Array of Array of numbers (Boundary) >= 3 items

A list of points representing the outer boundary vertices of the face. The list should include at least 3 points and each point should be a list of 3 (x, y, z) values.

type
string (Type) ^Face3D$
Default: "Face3D"
holes
Array of Array of Array of numbers (Holes)

Optional list of lists with one list for each hole in the face.Each hole should be a list of at least 3 points and each point a list of 3 (x, y, z) values. If None, it will be assumed that there are no holes in the face.

object (Plane)

Optional Plane indicating the plane in which the face exists.If None, the plane will usually be derived from the boundary points.

{
  • "boundary":
    [
    ],
  • "type": "Face3D",
  • "holes":
    [
    ],
  • "plane":
    {
    }
}

Face

identifier
required
string (Identifier) [ 1 .. 100 ] characters [A-Za-z0-9_-]

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, rad). This identifier is also used to reference the object across a Model. It must be < 100 characters and not contain any spaces or special characters.

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

type
string ^IDdBaseModel$
Default: "IDdBaseModel"
required
object (Geometry)

Planar Face3D for the geometry.

face_type
required
string (FaceType)
Enum: "Wall" "Floor" "RoofCeiling" "AirBoundary"

An enumeration.

required
Ground (object) or Outdoors (object) or Adiabatic (object) or Surface (object) (Boundary Condition)
required
object (Properties)

Extension properties for particular simulation engines (Radiance, EnergyPlus).

Array of objects (Apertures)

Apertures assigned to this Face. Should be coplanar with this Face and completely within the boundary of the Face to be valid.

Array of objects (Doors)

Doors assigned to this Face. Should be coplanar with this Face and completely within the boundary of the Face to be valid.

Array of objects (Indoor Shades)

Shades assigned to the interior side of this object.

Array of objects (Outdoor Shades)

Shades assigned to the exterior side of this object (eg. balcony, overhang).

{
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "type": "Face",
  • "geometry":
    {
    },
  • "face_type": "Wall",
  • "boundary_condition":
    {
    },
  • "properties":
    {
    },
  • "apertures":
    [
    ],
  • "doors":
    [
    ],
  • "indoor_shades":
    [
    ],
  • "outdoor_shades":
    [
    ]
}

FaceEnergyPropertiesAbridged

type
string (Type) ^FaceEnergyPropertiesAbridged$
Default: "FaceEnergyPropertiesAbridged"
construction
string (Construction) [ 1 .. 100 ] characters

Identifier of an OpaqueConstruction for the Face. If None, the construction is set by the parent Room construction_set or the Model global_construction_set.

object (Vent Crack)

An optional AFNCrack to specify airflow through a surface crack used by the AirflowNetwork.

{
  • "type": "FaceEnergyPropertiesAbridged",
  • "construction": "string",
  • "vent_crack":
    {
    }
}

FacePropertiesAbridged

type
string (Type) ^FacePropertiesAbridged$
Default: "FacePropertiesAbridged"
object (FaceEnergyPropertiesAbridged)

Base class for all objects that are not extensible with additional keys.

This effectively includes all objects except for the Properties classes that are assigned to geometry objects.

object (FaceRadiancePropertiesAbridged)

Radiance Properties for Honeybee Face Abridged.

{
  • "type": "FacePropertiesAbridged",
  • "energy":
    {
    },
  • "radiance":
    {
    }
}

FaceRadiancePropertiesAbridged

modifier
string (Modifier)

A string for a Honeybee Radiance Modifier (default: None).

modifier_blk
string (Modifier Blk)

A string for a Honeybee Radiance Modifier to be used in direct solar simulations and in isolation studies (assessingthe contribution of individual objects) (default: None).

type
string ^_PropertiesBaseAbridged$
Default: "_PropertiesBaseAbridged"
{
  • "modifier": "string",
  • "modifier_blk": "string",
  • "type": "FaceRadiancePropertiesAbridged"
}

FaceType

string (FaceType)
Enum: "Wall" "Floor" "RoofCeiling" "AirBoundary"

An enumeration.

"Wall"

FCU

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
vintage
string (Vintages)
Enum: "90.1-2013" "90.1-2010" "90.1-2007" "90.1-2004" "DOE Ref 1980-2004" "DOE Ref Pre-1980"

An enumeration.

equipment_type
string (FCUEquipmentType)
Enum: "Fan coil chiller with boiler" "Fan coil chiller with central air source heat pump" "Fan coil chiller with district hot water" "Fan coil chiller with baseboard electric" "Fan coil chiller with gas unit heaters" "Fan coil chiller with no heat" "Fan coil air-cooled chiller with boiler" "Fan coil air-cooled chiller with central air source heat pump" "Fan coil air-cooled chiller with district hot water" "Fan coil air-cooled chiller with baseboard electric" "Fan coil air-cooled chiller with gas unit heaters" "Fan coil air-cooled chiller with no heat" "Fan coil district chilled water with boiler" "Fan coil district chilled water with central air source heat pump" "Fan coil district chilled water with district hot water" "Fan coil district chilled water with baseboard electric" "Fan coil district chilled water with gas unit heaters" "Fan coil district chilled water with no heat"

An enumeration.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "FCU",
  • "vintage": "90.1-2013",
  • "equipment_type": "Fan coil chiller with boiler"
}

FCUEquipmentType

string (FCUEquipmentType)
Enum: "Fan coil chiller with boiler" "Fan coil chiller with central air source heat pump" "Fan coil chiller with district hot water" "Fan coil chiller with baseboard electric" "Fan coil chiller with gas unit heaters" "Fan coil chiller with no heat" "Fan coil air-cooled chiller with boiler" "Fan coil air-cooled chiller with central air source heat pump" "Fan coil air-cooled chiller with district hot water" "Fan coil air-cooled chiller with baseboard electric" "Fan coil air-cooled chiller with gas unit heaters" "Fan coil air-cooled chiller with no heat" "Fan coil district chilled water with boiler" "Fan coil district chilled water with central air source heat pump" "Fan coil district chilled water with district hot water" "Fan coil district chilled water with baseboard electric" "Fan coil district chilled water with gas unit heaters" "Fan coil district chilled water with no heat"

An enumeration.

"Fan coil chiller with boiler"

FCUwithDOAS

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
vintage
string (Vintages)
Enum: "90.1-2013" "90.1-2010" "90.1-2007" "90.1-2004" "DOE Ref 1980-2004" "DOE Ref Pre-1980"

An enumeration.

Autosize (object) or number (Sensible Heat Recovery)
Default: {"type":"Autosize"}

A number between 0 and 1 for the effectiveness of sensible heat recovery within the system. If None or Autosize, it will be whatever is recommended for the given vintage.

Autosize (object) or number (Latent Heat Recovery)
Default: {"type":"Autosize"}

A number between 0 and 1 for the effectiveness of latent heat recovery within the system. If None or Autosize, it will be whatever is recommended for the given vintage.

equipment_type
string (FCUwithDOASEquipmentType)
Enum: "DOAS with fan coil chiller with boiler" "DOAS with fan coil chiller with central air source heat pump" "DOAS with fan coil chiller with district hot water" "DOAS with fan coil chiller with baseboard electric" "DOAS with fan coil chiller with gas unit heaters" "DOAS with fan coil chiller with no heat" "DOAS with fan coil air-cooled chiller with boiler" "DOAS with fan coil air-cooled chiller with central air source heat pump" "DOAS with fan coil air-cooled chiller with district hot water" "DOAS with fan coil air-cooled chiller with baseboard electric" "DOAS with fan coil air-cooled chiller with gas unit heaters" "DOAS with fan coil air-cooled chiller with no heat" "DOAS with fan coil district chilled water with boiler" "DOAS with fan coil district chilled water with central air source heat pump" "DOAS with fan coil district chilled water with district hot water" "DOAS with fan coil district chilled water with baseboard electric" "DOAS with fan coil district chilled water with gas unit heaters" "DOAS with fan coil district chilled water with no heat"

An enumeration.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "FCUwithDOAS",
  • "vintage": "90.1-2013",
  • "sensible_heat_recovery":
    {
    },
  • "latent_heat_recovery":
    {
    },
  • "equipment_type": "DOAS with fan coil chiller with boiler"
}

FCUwithDOASEquipmentType

string (FCUwithDOASEquipmentType)
Enum: "DOAS with fan coil chiller with boiler" "DOAS with fan coil chiller with central air source heat pump" "DOAS with fan coil chiller with district hot water" "DOAS with fan coil chiller with baseboard electric" "DOAS with fan coil chiller with gas unit heaters" "DOAS with fan coil chiller with no heat" "DOAS with fan coil air-cooled chiller with boiler" "DOAS with fan coil air-cooled chiller with central air source heat pump" "DOAS with fan coil air-cooled chiller with district hot water" "DOAS with fan coil air-cooled chiller with baseboard electric" "DOAS with fan coil air-cooled chiller with gas unit heaters" "DOAS with fan coil air-cooled chiller with no heat" "DOAS with fan coil district chilled water with boiler" "DOAS with fan coil district chilled water with central air source heat pump" "DOAS with fan coil district chilled water with district hot water" "DOAS with fan coil district chilled water with baseboard electric" "DOAS with fan coil district chilled water with gas unit heaters" "DOAS with fan coil district chilled water with no heat"

An enumeration.

"DOAS with fan coil chiller with boiler"

FloorConstructionSet

object (Interior Construction)

An OpaqueConstruction for walls with a Surface or Adiabatic boundary condition.

object (Exterior Construction)

An OpaqueConstruction for walls with an Outdoors boundary condition.

object (Ground Construction)

An OpaqueConstruction for walls with a Ground boundary condition.

type
string (Type) ^FloorConstructionSet$
Default: "FloorConstructionSet"
{
  • "interior_construction":
    {
    },
  • "exterior_construction":
    {
    },
  • "ground_construction":
    {
    },
  • "type": "FloorConstructionSet"
}

FloorConstructionSetAbridged

interior_construction
string (Interior Construction) [ 1 .. 100 ] characters

Identifier for an OpaqueConstruction for faces with a Surface or Adiabatic boundary condition.

exterior_construction
string (Exterior Construction) [ 1 .. 100 ] characters

Identifier for an OpaqueConstruction for faces with an Outdoors boundary condition.

ground_construction
string (Ground Construction) [ 1 .. 100 ] characters

Identifier for an OpaqueConstruction for faces with a Ground boundary condition.

type
string ^_FaceSubSetAbridged$
Default: "_FaceSubSetAbridged"
{
  • "interior_construction": "string",
  • "exterior_construction": "string",
  • "ground_construction": "string",
  • "type": "FloorConstructionSetAbridged"
}

FloorModifierSet

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Exterior Modifier)

A radiance modifier object for faces with an Outdoors boundary condition.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Interior Modifier)

A radiance modifier object for faces with a boundary condition other than Outdoors.

type
string (Type) ^FloorModifierSet$
Default: "FloorModifierSet"
{
  • "exterior_modifier":
    {
    },
  • "interior_modifier":
    {
    },
  • "type": "FloorModifierSet"
}

FloorModifierSetAbridged

exterior_modifier
string (Exterior Modifier)

Identifier for a radiance modifier object for faces with an Outdoors boundary condition.

interior_modifier
string (Interior Modifier)

Identifier for a radiance modifier object for faces with a boundary condition other than Outdoors.

type
string ^BaseModifierSetAbridged$
Default: "BaseModifierSetAbridged"
{
  • "exterior_modifier": "string",
  • "interior_modifier": "string",
  • "type": "FloorModifierSetAbridged"
}

ForcedAirFurnace

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
vintage
string (Vintages)
Enum: "90.1-2013" "90.1-2010" "90.1-2007" "90.1-2004" "DOE Ref 1980-2004" "DOE Ref Pre-1980"

An enumeration.

economizer_type
string (AllAirEconomizerType)
Enum: "Inferred" "NoEconomizer" "DifferentialDryBulb" "DifferentialEnthalpy"

An enumeration.

Autosize (object) or number (Sensible Heat Recovery)
Default: {"type":"Autosize"}

A number between 0 and 1 for the effectiveness of sensible heat recovery within the system. If None or Autosize, it will be whatever is recommended for the given vintage.

Autosize (object) or number (Latent Heat Recovery)
Default: {"type":"Autosize"}

A number between 0 and 1 for the effectiveness of latent heat recovery within the system. If None or Autosize, it will be whatever is recommended for the given vintage.

equipment_type
string (FurnaceEquipmentType)
Value: "Forced air furnace"

An enumeration.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "ForcedAirFurnace",
  • "vintage": "90.1-2013",
  • "economizer_type": "Inferred",
  • "sensible_heat_recovery":
    {
    },
  • "latent_heat_recovery":
    {
    },
  • "equipment_type": "Forced air furnace"
}

FurnaceEquipmentType

string (FurnaceEquipmentType)
Value: "Forced air furnace"

An enumeration.

"Forced air furnace"

GasEquipment

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
watts_per_area
required
number <double> (Watts Per Area) >= 0

Equipment level per floor area as [W/m2].

required
ScheduleRuleset (object) or ScheduleFixedInterval (object) (Schedule)

The schedule for the use of equipment over the course of the year. The type of this schedule should be Fractional and the fractional values will get multiplied by the watts_per_area to yield a complete equipment profile.

radiant_fraction
number <double> (Radiant Fraction) [ 0 .. 1 ]
Default: 0

Number for the amount of long-wave radiation heat given off by electric equipment. Default value is 0.

latent_fraction
number <double> (Latent Fraction) [ 0 .. 1 ]
Default: 0

Number for the amount of latent heat given off by electricequipment. Default value is 0.

lost_fraction
number <double> (Lost Fraction) [ 0 .. 1 ]
Default: 0

Number for the amount of “lost” heat being given off by equipment. The default value is 0.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "GasEquipment",
  • "watts_per_area": 0,
  • "schedule":
    {
    },
  • "radiant_fraction": 0,
  • "latent_fraction": 0,
  • "lost_fraction": 0
}

GasEquipmentAbridged

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
watts_per_area
required
number <double> (Watts Per Area) >= 0

Equipment level per floor area as [W/m2].

schedule
required
string (Schedule) [ 1 .. 100 ] characters

Identifier of the schedule for the use of equipment over the course of the year. The type of this schedule should be Fractional and the fractional values will get multiplied by the watts_per_area to yield a complete equipment profile.

radiant_fraction
number <double> (Radiant Fraction) [ 0 .. 1 ]
Default: 0

Number for the amount of long-wave radiation heat given off by electric equipment. Default value is 0.

latent_fraction
number <double> (Latent Fraction) [ 0 .. 1 ]
Default: 0

Number for the amount of latent heat given off by electricequipment. Default value is 0.

lost_fraction
number <double> (Lost Fraction) [ 0 .. 1 ]
Default: 0

Number for the amount of “lost” heat being given off by equipment. The default value is 0.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "GasEquipmentAbridged",
  • "watts_per_area": 0,
  • "schedule": "string",
  • "radiant_fraction": 0,
  • "latent_fraction": 0,
  • "lost_fraction": 0
}

GasType

string (GasType)
Enum: "Air" "Argon" "Krypton" "Xenon"

An enumeration.

"Air"

GasUnitHeater

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
vintage
string (Vintages)
Enum: "90.1-2013" "90.1-2010" "90.1-2007" "90.1-2004" "DOE Ref 1980-2004" "DOE Ref Pre-1980"

An enumeration.

equipment_type
string (GasUnitHeaterEquipmentType)
Value: "Gas unit heaters"

An enumeration.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "GasUnitHeater",
  • "vintage": "90.1-2013",
  • "equipment_type": "Gas unit heaters"
}

GasUnitHeaterEquipmentType

string (GasUnitHeaterEquipmentType)
Value: "Gas unit heaters"

An enumeration.

"Gas unit heaters"

Glass

identifier
required
string (Identifier)

Text string for a unique Radiance object. Must not contain spaces or special characters. This will be used to identify the object across a model and in the exported Radiance files.

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdRadianceBaseModel$
Default: "IDdRadianceBaseModel"
Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Modifier)
Default: {"type":"void"}

Material modifier (default: Void).

Array of Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Dependencies)

List of modifiers that this modifier depends on. This argument is only useful for defining advanced modifiers where the modifier is defined based on other modifiers (default: None).

r_transmissivity
number <double> (R Transmissivity) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the red channel transmissivity (default: 0).

g_transmissivity
number <double> (G Transmissivity) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the green channel transmissivity (default: 0).

b_transmissivity
number <double> (B Transmissivity) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the blue channel transmissivity (default: 0).

refraction_index
number <double> (Refraction Index) >= 0
Default: 1.52

A value between 0 and 1 for the index of refraction (default: 1.52).

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "glass",
  • "modifier":
    {
    },
  • "dependencies":
    [
    ],
  • "r_transmissivity": 0,
  • "g_transmissivity": 0,
  • "b_transmissivity": 0,
  • "refraction_index": 1.52
}

Glow

identifier
required
string (Identifier)

Text string for a unique Radiance object. Must not contain spaces or special characters. This will be used to identify the object across a model and in the exported Radiance files.

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdRadianceBaseModel$
Default: "IDdRadianceBaseModel"
Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Modifier)
Default: {"type":"void"}

Material modifier (default: Void).

Array of Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Dependencies)

List of modifiers that this modifier depends on. This argument is only useful for defining advanced modifiers where the modifier is defined based on other modifiers (default: None).

r_emittance
number <double> (R Emittance) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the red channel of the modifier (default: 0).

g_emittance
number <double> (G Emittance) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the green channel of the modifier (default: 0).

b_emittance
number <double> (B Emittance) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the blue channel of the modifier (default: 0).

max_radius
number <double> (Max Radius)
Default: 0

Maximum radius for shadow testing (default: 0). Surfaces with zero will never be tested for zero, although it may participate in interreflection calculation. Negative values will never contribute to scene illumination.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "glow",
  • "modifier":
    {
    },
  • "dependencies":
    [
    ],
  • "r_emittance": 0,
  • "g_emittance": 0,
  • "b_emittance": 0,
  • "max_radius": 0
}

Ground

type
string (Type) ^Ground$
Default: "Ground"
{
  • "type": "Ground"
}

IDdBaseModel

identifier
required
string (Identifier) [ 1 .. 100 ] characters [A-Za-z0-9_-]

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, rad). This identifier is also used to reference the object across a Model. It must be < 100 characters and not contain any spaces or special characters.

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

type
string (Type) ^IDdBaseModel$
Default: "IDdBaseModel"
{
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "type": "IDdBaseModel"
}

IDdEnergyBaseModel

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string (Type) ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "IDdEnergyBaseModel"
}

IDdRadianceBaseModel

identifier
required
string (Identifier)

Text string for a unique Radiance object. Must not contain spaces or special characters. This will be used to identify the object across a model and in the exported Radiance files.

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string (Type) ^IDdRadianceBaseModel$
Default: "IDdRadianceBaseModel"
{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "IDdRadianceBaseModel"
}

IdealAirSystemAbridged

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
economizer_type
string (EconomizerType)
Enum: "NoEconomizer" "DifferentialDryBulb" "DifferentialEnthalpy"

An enumeration.

demand_controlled_ventilation
boolean (Demand Controlled Ventilation)
Default: false

Boolean to note whether demand controlled ventilation should be used on the system, which will vary the amount of ventilation air according to the occupancy schedule of the zone.

sensible_heat_recovery
number <double> (Sensible Heat Recovery) [ 0 .. 1 ]
Default: 0

A number between 0 and 1 for the effectiveness of sensible heat recovery within the system.

latent_heat_recovery
number <double> (Latent Heat Recovery) [ 0 .. 1 ]
Default: 0

A number between 0 and 1 for the effectiveness of latent heat recovery within the system.

heating_air_temperature
number <double> (Heating Air Temperature)
Default: 50

A number for the maximum heating supply air temperature [C].

cooling_air_temperature
number <double> (Cooling Air Temperature)
Default: 13

A number for the minimum cooling supply air temperature [C].

Autosize (object) or NoLimit (object) or number (Heating Limit)
Default: {"type":"Autosize"}

A number for the maximum heating capacity in Watts. This can also be an Autosize object to indicate that the capacity should be determined during the EnergyPlus sizing calculation. This can also be a NoLimit object to indicate no upper limit to the heating capacity.

Autosize (object) or NoLimit (object) or number (Cooling Limit)
Default: {"type":"Autosize"}

A number for the maximum cooling capacity in Watts. This can also be an Autosize object to indicate that the capacity should be determined during the EnergyPlus sizing calculation. This can also be a NoLimit object to indicate no upper limit to the cooling capacity.

heating_availability
string (Heating Availability) [ 1 .. 100 ] characters

An optional identifier of a schedule to set the availability of heating over the course of the simulation.

cooling_availability
string (Cooling Availability) [ 1 .. 100 ] characters

An optional identifier of a schedule to set the availability of cooling over the course of the simulation.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "IdealAirSystemAbridged",
  • "economizer_type": "NoEconomizer",
  • "demand_controlled_ventilation": false,
  • "sensible_heat_recovery": 0,
  • "latent_heat_recovery": 0,
  • "heating_air_temperature": 50,
  • "cooling_air_temperature": 13,
  • "heating_limit":
    {
    },
  • "cooling_limit":
    {
    },
  • "heating_availability": "string",
  • "cooling_availability": "string"
}

Infiltration

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
flow_per_exterior_area
required
number <double> (Flow Per Exterior Area) >= 0

Number for the infiltration per exterior surface area in m3/s-m2.

required
ScheduleRuleset (object) or ScheduleFixedInterval (object) (Schedule)

The schedule for the infiltration over the course of the year. The type of this schedule should be Fractional and the fractional values will get multiplied by the flow_per_exterior_area to yield a complete infiltration profile.

constant_coefficient
number <double> (Constant Coefficient) >= 0
Default: 1
temperature_coefficient
number <double> (Temperature Coefficient) >= 0
Default: 0
velocity_coefficient
number <double> (Velocity Coefficient) >= 0
Default: 0
{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "Infiltration",
  • "flow_per_exterior_area": 0,
  • "schedule":
    {
    },
  • "constant_coefficient": 1,
  • "temperature_coefficient": 0,
  • "velocity_coefficient": 0
}

InfiltrationAbridged

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
flow_per_exterior_area
required
number <double> (Flow Per Exterior Area) >= 0

Number for the infiltration per exterior surface area in m3/s-m2.

schedule
required
string (Schedule) [ 1 .. 100 ] characters

Identifier of the schedule for the infiltration over the course of the year. The type of this schedule should be Fractional and the fractional values will get multiplied by the flow_per_exterior_area to yield a complete infiltration profile.

constant_coefficient
number <double> (Constant Coefficient) >= 0
Default: 1
temperature_coefficient
number <double> (Temperature Coefficient) >= 0
Default: 0
velocity_coefficient
number <double> (Velocity Coefficient) >= 0
Default: 0
{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "InfiltrationAbridged",
  • "flow_per_exterior_area": 0,
  • "schedule": "string",
  • "constant_coefficient": 1,
  • "temperature_coefficient": 0,
  • "velocity_coefficient": 0
}

Light

identifier
required
string (Identifier)

Text string for a unique Radiance object. Must not contain spaces or special characters. This will be used to identify the object across a model and in the exported Radiance files.

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdRadianceBaseModel$
Default: "IDdRadianceBaseModel"
Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Modifier)
Default: {"type":"void"}

Material modifier (default: Void).

Array of Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Dependencies)

List of modifiers that this modifier depends on. This argument is only useful for defining advanced modifiers where the modifier is defined based on other modifiers (default: None).

r_emittance
number <double> (R Emittance) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the red channel of the modifier (default: 0).

g_emittance
number <double> (G Emittance) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the green channel of the modifier (default: 0).

b_emittance
number <double> (B Emittance) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the blue channel of the modifier (default: 0).

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "light",
  • "modifier":
    {
    },
  • "dependencies":
    [
    ],
  • "r_emittance": 0,
  • "g_emittance": 0,
  • "b_emittance": 0
}

Lighting

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
watts_per_area
required
number <double> (Watts Per Area) >= 0

Lighting per floor area as [W/m2].

required
ScheduleRuleset (object) or ScheduleFixedInterval (object) (Schedule)

The schedule for the use of lights over the course of the year. The type of this schedule should be Fractional and the fractional values will get multiplied by the watts_per_area to yield a complete lighting profile.

visible_fraction
number <double> (Visible Fraction) [ 0 .. 1 ]
Default: 0.25

The fraction of heat from lights that goes into the zone as visible (short-wave) radiation. The default value is 0.25.

radiant_fraction
number <double> (Radiant Fraction) [ 0 .. 1 ]
Default: 0.32

The fraction of heat from lights that is long-wave radiation. Default value is 0.32.

return_air_fraction
number <double> (Return Air Fraction) [ 0 .. 1 ]
Default: 0

The fraction of the heat from lights that goes into the zone return air. Default value is 0.

baseline_watts_per_area
number <double> (Baseline Watts Per Area) >= 0
Default: 11.84029

The baseline lighting power density in [W/m2] of floor area. This baseline is useful to track how much better the installed lights are in comparison to a standard like ASHRAE 90.1. If set to None, it will default to 11.84029 W/m2, which is that ASHRAE 90.1-2004 baseline for an office.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "Lighting",
  • "watts_per_area": 0,
  • "schedule":
    {
    },
  • "visible_fraction": 0.25,
  • "radiant_fraction": 0.32,
  • "return_air_fraction": 0,
  • "baseline_watts_per_area": 11.84029
}

LightingAbridged

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
watts_per_area
required
number <double> (Watts Per Area) >= 0

Lighting per floor area as [W/m2].

schedule
required
string (Schedule) [ 1 .. 100 ] characters

Identifier of the schedule for the use of lights over the course of the year. The type of this schedule should be Fractional and the fractional values will get multiplied by the watts_per_area to yield a complete lighting profile.

visible_fraction
number <double> (Visible Fraction) [ 0 .. 1 ]
Default: 0.25

The fraction of heat from lights that goes into the zone as visible (short-wave) radiation. The default value is 0.25.

radiant_fraction
number <double> (Radiant Fraction) [ 0 .. 1 ]
Default: 0.32

The fraction of heat from lights that is long-wave radiation. Default value is 0.32.

return_air_fraction
number <double> (Return Air Fraction) [ 0 .. 1 ]
Default: 0

The fraction of the heat from lights that goes into the zone return air. Default value is 0.

baseline_watts_per_area
number <double> (Baseline Watts Per Area) >= 0
Default: 11.84029

The baseline lighting power density in [W/m2] of floor area. This baseline is useful to track how much better the installed lights are in comparison to a standard like ASHRAE 90.1. If set to None, it will default to 11.84029 W/m2, which is that ASHRAE 90.1-2004 baseline for an office.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "LightingAbridged",
  • "watts_per_area": 0,
  • "schedule": "string",
  • "visible_fraction": 0.25,
  • "radiant_fraction": 0.32,
  • "return_air_fraction": 0,
  • "baseline_watts_per_area": 11.84029
}

Mesh3D

vertices
required
Array of Array of numbers (Vertices) >= 3 items

A list of points representing the vertices of the mesh. The list should include at least 3 points and each point should be a list of 3 (x, y, z) values.

faces
required
Array of Array of integers (Faces) non-empty

A list of lists with each sub-list having either 3 or 4 integers. These integers correspond to indices within the list of vertices.

type
string (Type) ^Mesh3D$
Default: "Mesh3D"
Array of objects (Colors)

An optional list of colors that correspond to either the faces of the mesh or the vertices of the mesh.

{
  • "vertices":
    [
    ],
  • "faces":
    [
    ],
  • "type": "Mesh3D",
  • "colors":
    [
    ]
}

Metal

identifier
required
string (Identifier)

Text string for a unique Radiance object. Must not contain spaces or special characters. This will be used to identify the object across a model and in the exported Radiance files.

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdRadianceBaseModel$
Default: "IDdRadianceBaseModel"
Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Modifier)
Default: {"type":"void"}

Material modifier (default: Void).

Array of Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Dependencies)

List of modifiers that this modifier depends on. This argument is only useful for defining advanced modifiers where the modifier is defined based on other modifiers (default: None).

r_reflectance
number <double> (R Reflectance) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the red channel reflectance (default: 0).

g_reflectance
number <double> (G Reflectance) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the green channel reflectance (default: 0).

b_reflectance
number <double> (B Reflectance) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the blue channel reflectance (default: 0).

specularity
number <double> (Specularity) [ 0 .. 1 ]
Default: 0.9

A value between 0 and 1 for the fraction of specularity. Specularity fractions lower than 0.9 are not realistic for metallic materials. (default: 0.9).

roughness
number <double> (Roughness) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the roughness, specified as the rms slope of surface facets. Roughness greater than 0.2 are not realistic (default: 0).

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "metal",
  • "modifier":
    {
    },
  • "dependencies":
    [
    ],
  • "r_reflectance": 0,
  • "g_reflectance": 0,
  • "b_reflectance": 0,
  • "specularity": 0.9,
  • "roughness": 0
}

Mirror

identifier
required
string (Identifier)

Text string for a unique Radiance object. Must not contain spaces or special characters. This will be used to identify the object across a model and in the exported Radiance files.

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdRadianceBaseModel$
Default: "IDdRadianceBaseModel"
Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Modifier)
Default: {"type":"void"}

Material modifier (default: Void).

Array of Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Dependencies)

List of modifiers that this modifier depends on. This argument is only useful for defining advanced modifiers where the modifier is defined based on other modifiers (default: None).

r_reflectance
number <double> (R Reflectance) [ 0 .. 1 ]
Default: 1

A value between 0 and 1 for the red channel reflectance (default: 1).

g_reflectance
number <double> (G Reflectance) [ 0 .. 1 ]
Default: 1

A value between 0 and 1 for the green channel reflectance (default: 1).

b_reflectance
number <double> (B Reflectance) [ 0 .. 1 ]
Default: 1

A value between 0 and 1 for the blue channel reflectance (default: 1).

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Alternate Material)

An optional material that may be used like the illum type to specify a different material to be used for shading non-source rays. If None, this will keep the alternat_material as mirror. If this alternate material is given as Void, then the mirror surface will be invisible. Using Void is only appropriate if the surface hides other (more detailed) geometry with the same overall reflectance (default: None).

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "mirror",
  • "modifier":
    {
    },
  • "dependencies":
    [
    ],
  • "r_reflectance": 1,
  • "g_reflectance": 1,
  • "b_reflectance": 1,
  • "alternate_material":
    {
    }
}

Model

identifier
required
string (Identifier) [ 1 .. 100 ] characters [A-Za-z0-9_-]

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, rad). This identifier is also used to reference the object across a Model. It must be < 100 characters and not contain any spaces or special characters.

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

type
string ^IDdBaseModel$
Default: "IDdBaseModel"
required
object (Properties)

Extension properties for particular simulation engines (Radiance, EnergyPlus).

version
string (Version) ([0-9]+)\.([0-9]+)\.([0-9]+)
Default: "1.39.0"

Text string for the current version of the schema.

Array of objects (Rooms)

A list of Rooms in the model.

Array of objects (Orphaned Faces)

A list of Faces in the model that lack a parent Room. Note that orphaned Faces are not acceptable for Models that are to be exported for energy simulation.

Array of objects (Orphaned Shades)

A list of Shades in the model that lack a parent.

Array of objects (Orphaned Apertures)

A list of Apertures in the model that lack a parent Face. Note that orphaned Apertures are not acceptable for Models that are to be exported for energy simulation.

Array of objects (Orphaned Doors)

A list of Doors in the model that lack a parent Face. Note that orphaned Doors are not acceptable for Models that are to be exported for energy simulation.

units
string (Units)
Enum: "Meters" "Millimeters" "Feet" "Inches" "Centimeters"

An enumeration.

tolerance
number <double> (Tolerance) >= 0
Default: 0.01

The maximum difference between x, y, and z values at which vertices are considered equivalent. This value should be in the Model units and it is used in a variety of checks, including checks for whether Room faces form a closed volume and subsequently correcting all face normals point outward from the Room. A value of 0 will result in bypassing all checks so it is recommended that this always be a positive number when such checks have not already been performed on a Model. The default of 0.01 is suitable for models in meters.

angle_tolerance
number <double> (Angle Tolerance) >= 0
Default: 1

The max angle difference in degrees that vertices are allowed to differ from one another in order to consider them colinear. This value is used in a variety of checks, including checks for whether Room faces form a closed volume and subsequently correcting all face normals point outward from the Room. A value of 0 will result in bypassing all checks so it is recommended that this always be a positive number when such checks have not already been performed on a given Model.

{
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "type": "Model",
  • "properties":
    {
    },
  • "version": "1.39.0",
  • "rooms":
    [
    ],
  • "orphaned_faces":
    [
    ],
  • "orphaned_shades":
    [
    ],
  • "orphaned_apertures":
    [
    ],
  • "orphaned_doors":
    [
    ],
  • "units": "Meters",
  • "tolerance": 0.01,
  • "angle_tolerance": 1
}

ModelEnergyProperties

type
string (Type) ^ModelEnergyProperties$
Default: "ModelEnergyProperties"
Array of ConstructionSetAbridged (object) or ConstructionSet (object) (Construction Sets)

List of all unique ConstructionSets in the Model.

Array of OpaqueConstructionAbridged (object) or WindowConstructionAbridged (object) or WindowConstructionShadeAbridged (object) or AirBoundaryConstructionAbridged (object) or OpaqueConstruction (object) or WindowConstruction (object) or WindowConstructionShade (object) or AirBoundaryConstruction (object) or ShadeConstruction (object) (Constructions)

A list of all unique constructions in the model. This includes constructions across all Faces, Apertures, Doors, Shades, Room ConstructionSets, and the global_construction_set.

Array of EnergyMaterial (object) or EnergyMaterialNoMass (object) or EnergyWindowMaterialGas (object) or EnergyWindowMaterialGasCustom (object) or EnergyWindowMaterialGasMixture (object) or EnergyWindowMaterialSimpleGlazSys (object) or EnergyWindowMaterialBlind (object) or EnergyWindowMaterialGlazing (object) or EnergyWindowMaterialShade (object) (Materials)

A list of all unique materials in the model. This includes materials needed to make the Model constructions.

Array of IdealAirSystemAbridged (object) or VAV (object) or PVAV (object) or PSZ (object) or PTAC (object) or ForcedAirFurnace (object) or FCUwithDOAS (object) or WSHPwithDOAS (object) or VRFwithDOAS (object) or FCU (object) or WSHP (object) or VRF (object) or Baseboard (object) or EvaporativeCooler (object) or Residential (object) or WindowAC (object) or GasUnitHeater (object) (Hvacs)

List of all unique HVAC systems in the Model.

Array of ProgramTypeAbridged (object) or ProgramType (object) (Program Types)

List of all unique ProgramTypes in the Model.

Array of ScheduleRulesetAbridged (object) or ScheduleFixedIntervalAbridged (object) or ScheduleRuleset (object) or ScheduleFixedInterval (object) (Schedules)

A list of all unique schedules in the model. This includes schedules across all HVAC systems, ProgramTypes, Rooms, and Shades.

Array of objects (Schedule Type Limits)

A list of all unique ScheduleTypeLimits in the model. This all ScheduleTypeLimits needed to make the Model schedules.

object (Ventilation Simulation Control)

An optional parameter to define the global parameters for a ventilation cooling.

{
  • "type": "ModelEnergyProperties",
  • "construction_sets":
    [
    ],
  • "constructions":
    [
    ],
  • "materials":
    [
    ],
  • "hvacs":
    [
    ],
  • "program_types":
    [
    ],
  • "schedules":
    [
    ],
  • "schedule_type_limits":
    [
    ],
  • "ventilation_simulation_control":
    {
    }
}

ModelProperties

type
string (Type) ^ModelProperties$
Default: "ModelProperties"
object (ModelEnergyProperties)

Base class for all objects that are not extensible with additional keys.

This effectively includes all objects except for the Properties classes that are assigned to geometry objects.

object (ModelRadianceProperties)

Radiance Properties for Honeybee Model.

{
  • "type": "ModelProperties",
  • "energy":
    {
    },
  • "radiance":
    {
    }
}

ModelRadianceProperties

type
string (Type) ^ModelRadianceProperties$
Default: "ModelRadianceProperties"
Array of Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Modifiers)

A list of all unique modifiers in the model. This includes modifiers across all Faces, Apertures, Doors, Shades, Room ModifierSets, and the global_modifier_set.

Array of ModifierSet (object) or ModifierSetAbridged (object) (Modifier Sets)

A list of all unique Room-Assigned ModifierSets in the Model.

Array of objects (Sensor Grids)

An array of SensorGrids that are associated with the model.

Array of objects (Views)

An array of Views that are associated with the model.

{
  • "type": "ModelRadianceProperties",
  • "modifiers":
    [
    ],
  • "modifier_sets":
    [
    ],
  • "sensor_grids":
    [
    ],
  • "views":
    [
    ]
}

ModifierBase

identifier
required
string (Identifier)

Text string for a unique Radiance object. Must not contain spaces or special characters. This will be used to identify the object across a model and in the exported Radiance files.

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdRadianceBaseModel$
Default: "IDdRadianceBaseModel"
{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "ModifierBase"
}

ModifierSet

identifier
required
string (Identifier)

Text string for a unique Radiance object. Must not contain spaces or special characters. This will be used to identify the object across a model and in the exported Radiance files.

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdRadianceBaseModel$
Default: "IDdRadianceBaseModel"
object (Wall Set)

An optional WallModifierSet object for this ModifierSet. (default: None).

object (Floor Set)

An optional FloorModifierSet object for this ModifierSet. (default: None).

object (Roof Ceiling Set)

An optional RoofCeilingModifierSet object for this ModifierSet. (default: None).

object (Aperture Set)

An optional ApertureModifierSet object for this ModifierSet. (default: None).

object (Door Set)

An optional DoorModifierSet object for this ModifierSet. (default: None).

object (Shade Set)

An optional ShadeModifierSet object for this ModifierSet. (default: None).

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Air Boundary Modifier)

An optional Modifier to be used for all Faces with an AirBoundary face type. If None, it will be the honeybee generic air wall modifier.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "ModifierSet",
  • "wall_set":
    {
    },
  • "floor_set":
    {
    },
  • "roof_ceiling_set":
    {
    },
  • "aperture_set":
    {
    },
  • "door_set":
    {
    },
  • "shade_set":
    {
    },
  • "air_boundary_modifier":
    {
    }
}

ModifierSetAbridged

identifier
required
string (Identifier)

Text string for a unique Radiance object. Must not contain spaces or special characters. This will be used to identify the object across a model and in the exported Radiance files.

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdRadianceBaseModel$
Default: "IDdRadianceBaseModel"
object (Wall Set)

Optional WallModifierSet object for this ModifierSet (default: None).

object (Floor Set)

Optional FloorModifierSet object for this ModifierSet (default: None).

object (Roof Ceiling Set)

Optional RoofCeilingModifierSet object for this ModifierSet (default: None).

object (Aperture Set)

Optional ApertureModifierSet object for this ModifierSet (default: None).

object (Door Set)

Optional DoorModifierSet object for this ModifierSet (default: None).

object (Shade Set)

Optional ShadeModifierSet object for this ModifierSet (default: None).

air_boundary_modifier
string (Air Boundary Modifier)

Optional Modifier to be used for all Faces with an AirBoundary face type. If None, it will be the honeybee generic air wall modifier.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "ModifierSetAbridged",
  • "wall_set":
    {
    },
  • "floor_set":
    {
    },
  • "roof_ceiling_set":
    {
    },
  • "aperture_set":
    {
    },
  • "door_set":
    {
    },
  • "shade_set":
    {
    },
  • "air_boundary_modifier": "string"
}

NoLimit

type
string (Type) ^NoLimit$
Default: "NoLimit"
{
  • "type": "NoLimit"
}

OpaqueConstruction

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
layers
required
Array of strings (Layers) [ 1 .. 10 ] items

List of strings for opaque material identifiers. The order of the materials is from exterior to interior.

required
Array of EnergyMaterial (object) or EnergyMaterialNoMass (object) (Materials) [ 1 .. 10 ] items

List of opaque materials. The order of the materials is from outside to inside.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "OpaqueConstruction",
  • "layers":
    [
    ],
  • "materials":
    [
    ]
}

OpaqueConstructionAbridged

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
layers
required
Array of strings (Layers) [ 1 .. 10 ] items

List of strings for opaque material identifiers. The order of the materials is from exterior to interior.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "OpaqueConstructionAbridged",
  • "layers":
    [
    ]
}

Outdoors

type
string (Type) ^Outdoors$
Default: "Outdoors"
sun_exposure
boolean (Sun Exposure)
Default: true

A boolean noting whether the boundary is exposed to sun.

wind_exposure
boolean (Wind Exposure)
Default: true

A boolean noting whether the boundary is exposed to wind.

Autocalculate (object) or number (View Factor)
Default: {"type":"Autocalculate"}

A number for the view factor to the ground. This can also be an Autocalculate object to have the view factor automatically calculated.

{
  • "type": "Outdoors",
  • "sun_exposure": true,
  • "wind_exposure": true,
  • "view_factor":
    {
    }
}

People

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
people_per_area
required
number <double> (People Per Area) >= 0

People per floor area expressed as [people/m2]

required
ScheduleRuleset (object) or ScheduleFixedInterval (object) (Occupancy Schedule)

A schedule for the occupancy over the course of the year. The type of this schedule should be Fractional and the fractional values will get multiplied by the people_per_area to yield a complete occupancy profile.

required
ScheduleRuleset (object) or ScheduleFixedInterval (object) (Activity Schedule)

A schedule for the activity of the occupants over the course of the year. The type of this schedule should be Power and the values of the schedule equal to the number of Watts given off by an individual person in the room.

radiant_fraction
number <double> (Radiant Fraction) [ 0 .. 1 ]
Default: 0.3

The radiant fraction of sensible heat released by people. The defaultvalue is 0.30.

Autocalculate (object) or number (Latent Fraction)
Default: {"type":"Autocalculate"}

Number for the latent fraction of heat gain due to people or an Autocalculate object.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "People",
  • "people_per_area": 0,
  • "occupancy_schedule":
    {
    },
  • "activity_schedule":
    {
    },
  • "radiant_fraction": 0.3,
  • "latent_fraction":
    {
    }
}

PeopleAbridged

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
people_per_area
required
number <double> (People Per Area) >= 0

People per floor area expressed as [people/m2]

occupancy_schedule
required
string (Occupancy Schedule) [ 1 .. 100 ] characters

Identifier of a schedule for the occupancy over the course of the year. The type of this schedule should be Fractional and the fractional values will get multiplied by the people_per_area to yield a complete occupancy profile.

activity_schedule
required
string (Activity Schedule) [ 1 .. 100 ] characters

Identifier of a schedule for the activity of the occupants over the course of the year. The type of this schedule should be Power and the values of the schedule equal to the number of Watts given off by an individual person in the room.

radiant_fraction
number <double> (Radiant Fraction) [ 0 .. 1 ]
Default: 0.3

The radiant fraction of sensible heat released by people. The defaultvalue is 0.30.

Autocalculate (object) or number (Latent Fraction)
Default: {"type":"Autocalculate"}

Number for the latent fraction of heat gain due to people or an Autocalculate object.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "PeopleAbridged",
  • "people_per_area": 0,
  • "occupancy_schedule": "string",
  • "activity_schedule": "string",
  • "radiant_fraction": 0.3,
  • "latent_fraction":
    {
    }
}

Plane

n
required
Array of numbers <double> (N) 3 items

Plane normal as 3 (x, y, z) values.

o
required
Array of numbers <double> (O) 3 items

Plane origin as 3 (x, y, z) values

type
string (Type) ^Plane$
Default: "Plane"
x
Array of numbers <double> (X) 3 items

Plane x-axis as 3 (x, y, z) values. If None, it is autocalculated.

{
  • "n":
    [
    ],
  • "o":
    [
    ],
  • "type": "Plane",
  • "x":
    [
    ]
}

Plastic

identifier
required
string (Identifier)

Text string for a unique Radiance object. Must not contain spaces or special characters. This will be used to identify the object across a model and in the exported Radiance files.

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdRadianceBaseModel$
Default: "IDdRadianceBaseModel"
Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Modifier)
Default: {"type":"void"}

Material modifier (default: Void).

Array of Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Dependencies)

List of modifiers that this modifier depends on. This argument is only useful for defining advanced modifiers where the modifier is defined based on other modifiers (default: None).

r_reflectance
number <double> (R Reflectance) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the red channel reflectance (default: 0).

g_reflectance
number <double> (G Reflectance) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the green channel reflectance (default: 0).

b_reflectance
number <double> (B Reflectance) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the blue channel reflectance (default: 0).

specularity
number <double> (Specularity) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the fraction of specularity. Specularity fractions greater than 0.1 are not realistic for non-metallic materials. (default: 0).

roughness
number <double> (Roughness) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the roughness, specified as the rms slope of surface facets. Roughness greater than 0.2 are not realistic (default: 0).

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "plastic",
  • "modifier": null,
  • "dependencies":
    [
    ],
  • "r_reflectance": 0,
  • "g_reflectance": 0,
  • "b_reflectance": 0,
  • "specularity": 0,
  • "roughness": 0
}

ProgramType

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
people
object (People) Recursive

People to describe the occupancy of the program. If None, no occupancy will be assumed for the program.

lighting
object (Lighting) Recursive

Lighting to describe the lighting usage of the program. If None, no lighting will be assumed for the program.

electric_equipment
object (Electric Equipment) Recursive

ElectricEquipment to describe the usage of electric equipment within the program. If None, no electric equipment will be assumed.

gas_equipment
object (Gas Equipment) Recursive

GasEquipment to describe the usage of gas equipment within the program. If None, no gas equipment will be assumed.

infiltration
object (Infiltration) Recursive

Infiltration to describe the outdoor air leakage of the program. If None, no infiltration will be assumed for the program.

ventilation
object (Ventilation) Recursive

Ventilation to describe the minimum outdoor air requirement of the program. If None, no ventilation requirement will be assumed.

setpoint
object (Setpoint) Recursive

Setpoint object to describe the temperature and humidity setpoints of the program. If None, the ProgramType cannot be assigned to a Room that is conditioned.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "ProgramType",
  • "people":
    {
    },
  • "lighting":
    {
    },
  • "electric_equipment":
    {
    },
  • "gas_equipment":
    {
    },
  • "infiltration":
    {
    },
  • "ventilation":
    {
    },
  • "setpoint":
    {
    }
}

ProgramTypeAbridged

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
people
object (People) Recursive

People to describe the occupancy of the program. If None, no occupancy will be assumed for the program.

lighting
object (Lighting) Recursive

Lighting to describe the lighting usage of the program. If None, no lighting will be assumed for the program.

electric_equipment
object (Electric Equipment) Recursive

ElectricEquipment to describe the usage of electric equipment within the program. If None, no electric equipment will be assumed.

gas_equipment
object (Gas Equipment) Recursive

GasEquipment to describe the usage of gas equipment within the program. If None, no gas equipment will be assumed.

infiltration
object (Infiltration) Recursive

Infiltration to describe the outdoor air leakage of the program. If None, no infiltration will be assumed for the program.

ventilation
object (Ventilation) Recursive

Ventilation to describe the minimum outdoor air requirement of the program. If None, no ventilation requirement will be assumed.

setpoint
object (Setpoint) Recursive

Setpoint object to describe the temperature and humidity setpoints of the program. If None, the ProgramType cannot be assigned to a Room that is conditioned.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "ProgramTypeAbridged",
  • "people":
    {
    },
  • "lighting":
    {
    },
  • "electric_equipment":
    {
    },
  • "gas_equipment":
    {
    },
  • "infiltration":
    {
    },
  • "ventilation":
    {
    },
  • "setpoint":
    {
    }
}

PSZ

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
vintage
string (Vintages)
Enum: "90.1-2013" "90.1-2010" "90.1-2007" "90.1-2004" "DOE Ref 1980-2004" "DOE Ref Pre-1980"

An enumeration.

economizer_type
string (AllAirEconomizerType)
Enum: "Inferred" "NoEconomizer" "DifferentialDryBulb" "DifferentialEnthalpy"

An enumeration.

Autosize (object) or number (Sensible Heat Recovery)
Default: {"type":"Autosize"}

A number between 0 and 1 for the effectiveness of sensible heat recovery within the system. If None or Autosize, it will be whatever is recommended for the given vintage.

Autosize (object) or number (Latent Heat Recovery)
Default: {"type":"Autosize"}

A number between 0 and 1 for the effectiveness of latent heat recovery within the system. If None or Autosize, it will be whatever is recommended for the given vintage.

equipment_type
string (PSZEquipmentType)
Enum: "PSZ-AC with baseboard electric" "PSZ-AC with baseboard gas boiler" "PSZ-AC with baseboard district hot water" "PSZ-AC with gas unit heaters" "PSZ-AC with electric coil" "PSZ-AC with gas coil" "PSZ-AC with gas boiler" "PSZ-AC with central air source heat pump" "PSZ-AC with district hot water" "PSZ-AC with no heat" "PSZ-AC district chilled water with baseboard electric" "PSZ-AC district chilled water with baseboard gas boiler" "PSZ-AC district chilled water with baseboard district hot water" "PSZ-AC district chilled water with gas unit heaters" "PSZ-AC district chilled water with electric coil" "PSZ-AC district chilled water with gas coil" "PSZ-AC district chilled water with gas boiler" "PSZ-AC district chilled water with central air source heat pump" "PSZ-AC district chilled water with district hot water" "PSZ-AC district chilled water with no heat" "PSZ-HP"

An enumeration.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "PSZ",
  • "vintage": "90.1-2013",
  • "economizer_type": "Inferred",
  • "sensible_heat_recovery":
    {
    },
  • "latent_heat_recovery":
    {
    },
  • "equipment_type": "PSZ-AC with baseboard electric"
}

PSZEquipmentType

string (PSZEquipmentType)
Enum: "PSZ-AC with baseboard electric" "PSZ-AC with baseboard gas boiler" "PSZ-AC with baseboard district hot water" "PSZ-AC with gas unit heaters" "PSZ-AC with electric coil" "PSZ-AC with gas coil" "PSZ-AC with gas boiler" "PSZ-AC with central air source heat pump" "PSZ-AC with district hot water" "PSZ-AC with no heat" "PSZ-AC district chilled water with baseboard electric" "PSZ-AC district chilled water with baseboard gas boiler" "PSZ-AC district chilled water with baseboard district hot water" "PSZ-AC district chilled water with gas unit heaters" "PSZ-AC district chilled water with electric coil" "PSZ-AC district chilled water with gas coil" "PSZ-AC district chilled water with gas boiler" "PSZ-AC district chilled water with central air source heat pump" "PSZ-AC district chilled water with district hot water" "PSZ-AC district chilled water with no heat" "PSZ-HP"

An enumeration.

"PSZ-AC with baseboard electric"

PTAC

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
vintage
string (Vintages)
Enum: "90.1-2013" "90.1-2010" "90.1-2007" "90.1-2004" "DOE Ref 1980-2004" "DOE Ref Pre-1980"

An enumeration.

economizer_type
string (AllAirEconomizerType)
Enum: "Inferred" "NoEconomizer" "DifferentialDryBulb" "DifferentialEnthalpy"

An enumeration.

Autosize (object) or number (Sensible Heat Recovery)
Default: {"type":"Autosize"}

A number between 0 and 1 for the effectiveness of sensible heat recovery within the system. If None or Autosize, it will be whatever is recommended for the given vintage.

Autosize (object) or number (Latent Heat Recovery)
Default: {"type":"Autosize"}

A number between 0 and 1 for the effectiveness of latent heat recovery within the system. If None or Autosize, it will be whatever is recommended for the given vintage.

equipment_type
string (PTACEquipmentType)
Enum: "PTAC with baseboard electric" "PTAC with baseboard gas boiler" "PTAC with baseboard district hot water" "PTAC with gas unit heaters" "PTAC with electric coil" "PTAC with gas coil" "PTAC with gas boiler" "PTAC with central air source heat pump" "PTAC with district hot water" "PTAC with no heat" "PTHP"

An enumeration.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "PTAC",
  • "vintage": "90.1-2013",
  • "economizer_type": "Inferred",
  • "sensible_heat_recovery":
    {
    },
  • "latent_heat_recovery":
    {
    },
  • "equipment_type": "PTAC with baseboard electric"
}

PTACEquipmentType

string (PTACEquipmentType)
Enum: "PTAC with baseboard electric" "PTAC with baseboard gas boiler" "PTAC with baseboard district hot water" "PTAC with gas unit heaters" "PTAC with electric coil" "PTAC with gas coil" "PTAC with gas boiler" "PTAC with central air source heat pump" "PTAC with district hot water" "PTAC with no heat" "PTHP"

An enumeration.

"PTAC with baseboard electric"

PVAV

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
vintage
string (Vintages)
Enum: "90.1-2013" "90.1-2010" "90.1-2007" "90.1-2004" "DOE Ref 1980-2004" "DOE Ref Pre-1980"

An enumeration.

economizer_type
string (AllAirEconomizerType)
Enum: "Inferred" "NoEconomizer" "DifferentialDryBulb" "DifferentialEnthalpy"

An enumeration.

Autosize (object) or number (Sensible Heat Recovery)
Default: {"type":"Autosize"}

A number between 0 and 1 for the effectiveness of sensible heat recovery within the system. If None or Autosize, it will be whatever is recommended for the given vintage.

Autosize (object) or number (Latent Heat Recovery)
Default: {"type":"Autosize"}

A number between 0 and 1 for the effectiveness of latent heat recovery within the system. If None or Autosize, it will be whatever is recommended for the given vintage.

equipment_type
string (PVAVEquipmentType)
Enum: "PVAV with gas boiler reheat" "PVAV with central air source heat pump reheat" "PVAV with district hot water reheat" "PVAV with PFP boxes" "PVAV with gas heat with electric reheat"

An enumeration.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "PVAV",
  • "vintage": "90.1-2013",
  • "economizer_type": "Inferred",
  • "sensible_heat_recovery":
    {
    },
  • "latent_heat_recovery":
    {
    },
  • "equipment_type": "PVAV with gas boiler reheat"
}

PVAVEquipmentType

string (PVAVEquipmentType)
Enum: "PVAV with gas boiler reheat" "PVAV with central air source heat pump reheat" "PVAV with district hot water reheat" "PVAV with PFP boxes" "PVAV with gas heat with electric reheat"

An enumeration.

"PVAV with gas boiler reheat"

RadianceShadeStateAbridged

type
string (Type) ^RadianceShadeStateAbridged$
Default: "RadianceShadeStateAbridged"
modifier
string (Modifier)

A Radiance Modifier identifier (default: None).

modifier_direct
string (Modifier Direct)

A Radiance Modifier identifier (default: None).

Array of objects (Shades)

A list of StateGeometryAbridged objects (default: None).

{
  • "type": "RadianceShadeStateAbridged",
  • "modifier": "string",
  • "modifier_direct": "string",
  • "shades":
    [
    ]
}

RadianceSubFaceStateAbridged

type
string ^RadianceShadeStateAbridged$
Default: "RadianceShadeStateAbridged"
modifier
string (Modifier)

A Radiance Modifier identifier (default: None).

modifier_direct
string (Modifier Direct)

A Radiance Modifier identifier (default: None).

Array of objects (Shades)

A list of StateGeometryAbridged objects (default: None).

object (Vmtx Geometry)

A Face3D for the view matrix geometry (default: None).

object (Dmtx Geometry)

A Face3D for the daylight matrix geometry (default: None).

{
  • "type": "RadianceSubFaceStateAbridged",
  • "modifier": "string",
  • "modifier_direct": "string",
  • "shades":
    [
    ],
  • "vmtx_geometry":
    {
    },
  • "dmtx_geometry":
    {
    }
}

Residential

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
vintage
string (Vintages)
Enum: "90.1-2013" "90.1-2010" "90.1-2007" "90.1-2004" "DOE Ref 1980-2004" "DOE Ref Pre-1980"

An enumeration.

equipment_type
string (ResidentialEquipmentType)
Enum: "Residential AC with baseboard electric" "Residential AC with baseboard gas boiler" "Residential AC with baseboard central air source heat pump" "Residential AC with baseboard district hot water" "Residential AC with residential forced air furnace" "Residential AC with no heat" "Residential heat pump" "Residential heat pump with no cooling" "Residential forced air furnace"

An enumeration.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "Residential",
  • "vintage": "90.1-2013",
  • "equipment_type": "Residential AC with baseboard electric"
}

ResidentialEquipmentType

string (ResidentialEquipmentType)
Enum: "Residential AC with baseboard electric" "Residential AC with baseboard gas boiler" "Residential AC with baseboard central air source heat pump" "Residential AC with baseboard district hot water" "Residential AC with residential forced air furnace" "Residential AC with no heat" "Residential heat pump" "Residential heat pump with no cooling" "Residential forced air furnace"

An enumeration.

"Residential AC with baseboard electric"

RoofCeilingConstructionSet

object (Interior Construction)

An OpaqueConstruction for walls with a Surface or Adiabatic boundary condition.

object (Exterior Construction)

An OpaqueConstruction for walls with an Outdoors boundary condition.

object (Ground Construction)

An OpaqueConstruction for walls with a Ground boundary condition.

type
string (Type) ^RoofCeilingConstructionSet$
Default: "RoofCeilingConstructionSet"
{
  • "interior_construction":
    {
    },
  • "exterior_construction":
    {
    },
  • "ground_construction":
    {
    },
  • "type": "RoofCeilingConstructionSet"
}

RoofCeilingConstructionSetAbridged

interior_construction
string (Interior Construction) [ 1 .. 100 ] characters

Identifier for an OpaqueConstruction for faces with a Surface or Adiabatic boundary condition.

exterior_construction
string (Exterior Construction) [ 1 .. 100 ] characters

Identifier for an OpaqueConstruction for faces with an Outdoors boundary condition.

ground_construction
string (Ground Construction) [ 1 .. 100 ] characters

Identifier for an OpaqueConstruction for faces with a Ground boundary condition.

type
string ^_FaceSubSetAbridged$
Default: "_FaceSubSetAbridged"
{
  • "interior_construction": "string",
  • "exterior_construction": "string",
  • "ground_construction": "string",
  • "type": "RoofCeilingConstructionSetAbridged"
}

RoofCeilingModifierSet

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Exterior Modifier)

A radiance modifier object for faces with an Outdoors boundary condition.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Interior Modifier)

A radiance modifier object for faces with a boundary condition other than Outdoors.

type
string (Type) ^RoofCeilingModifierSet$
Default: "RoofCeilingModifierSet"
{
  • "exterior_modifier":
    {
    },
  • "interior_modifier":
    {
    },
  • "type": "RoofCeilingModifierSet"
}

RoofCeilingModifierSetAbridged

exterior_modifier
string (Exterior Modifier)

Identifier for a radiance modifier object for faces with an Outdoors boundary condition.

interior_modifier
string (Interior Modifier)

Identifier for a radiance modifier object for faces with a boundary condition other than Outdoors.

type
string ^BaseModifierSetAbridged$
Default: "BaseModifierSetAbridged"
{
  • "exterior_modifier": "string",
  • "interior_modifier": "string",
  • "type": "RoofCeilingModifierSetAbridged"
}

Room

identifier
required
string (Identifier) [ 1 .. 100 ] characters [A-Za-z0-9_-]

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, rad). This identifier is also used to reference the object across a Model. It must be < 100 characters and not contain any spaces or special characters.

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

type
string ^IDdBaseModel$
Default: "IDdBaseModel"
required
Array of objects (Faces) >= 4 items

Faces that together form the closed volume of a room.

required
object (Properties)

Extension properties for particular simulation engines (Radiance, EnergyPlus).

Array of objects (Indoor Shades)

Shades assigned to the interior side of this object (eg. partitions, tables).

Array of objects (Outdoor Shades)

Shades assigned to the exterior side of this object (eg. trees, landscaping).

multiplier
integer <int32> (Multiplier) >= 1
Default: 1

An integer noting how many times this Room is repeated. Multipliers are used to speed up the calculation when similar Rooms are repeated more than once. Essentially, a given simulation with the Room is run once and then the result is mutliplied by the multiplier.

story
string (Story) [ 1 .. 100 ] characters [A-Za-z0-9_-]

Text string for the story identifier to which this Room belongs. Rooms sharing the same story identifier are considered part of the same story in a Model.

{
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "type": "Room",
  • "faces":
    [
    ],
  • "properties":
    {
    },
  • "indoor_shades":
    [
    ],
  • "outdoor_shades":
    [
    ],
  • "multiplier": 1,
  • "story": "string"
}

RoomEnergyPropertiesAbridged

type
string (Type) ^RoomEnergyPropertiesAbridged$
Default: "RoomEnergyPropertiesAbridged"
construction_set
string (Construction Set) [ 1 .. 100 ] characters

Identifier of a ConstructionSet to specify all default constructions for the Faces, Apertures, and Doors of the Room. If None, the Room will use the Model global_construction_set.

program_type
string (Program Type) [ 1 .. 100 ] characters

Identifier of a ProgramType to specify all default schedules and loads for the Room. If None, the Room will have no loads or setpoints.

hvac
string (Hvac) [ 1 .. 100 ] characters

An optional identifier of a HVAC system (such as an IdealAirSystem) that specifies how the Room is conditioned. If None, it will be assumed that the Room is not conditioned.

object (People)

People object to describe the occupancy of the Room.

object (Lighting)

Lighting object to describe the lighting usage of the Room.

object (Electric Equipment)

ElectricEquipment object to describe the electric equipment usage.

object (Gas Equipment)

GasEquipment object to describe the gas equipment usage.

object (Infiltration)

Infiltration object to to describe the outdoor air leakage.

object (Ventilation)

Ventilation object for the minimum outdoor air requirement.

object (Setpoint)

Setpoint object for the temperature setpoints of the Room.

object (Window Vent Control)

An optional VentilationControl object to dictate the opening of windows. If None, the windows will never open.

{
  • "type": "RoomEnergyPropertiesAbridged",
  • "construction_set": "string",
  • "program_type": "string",
  • "hvac": "string",
  • "people":
    {
    },
  • "lighting":
    {
    },
  • "electric_equipment":
    {
    },
  • "gas_equipment":
    {
    },
  • "infiltration":
    {
    },
  • "ventilation":
    {
    },
  • "setpoint":
    {
    },
  • "window_vent_control":
    {
    }
}

RoomPropertiesAbridged

type
string (Type) ^RoomPropertiesAbridged$
Default: "RoomPropertiesAbridged"
object (RoomEnergyPropertiesAbridged)

Base class for all objects that are not extensible with additional keys.

This effectively includes all objects except for the Properties classes that are assigned to geometry objects.

object (RoomRadiancePropertiesAbridged)

Abridged Radiance Properties for Honeybee Room.

{
  • "type": "RoomPropertiesAbridged",
  • "energy":
    {
    },
  • "radiance":
    {
    }
}

RoomRadiancePropertiesAbridged

type
string (Type) ^RoomRadiancePropertiesAbridged$
Default: "RoomRadiancePropertiesAbridged"
modifier_set
string (Modifier Set)

An identifier for a unique Room-Assigned ModifierSet (default: None).

{
  • "type": "RoomRadiancePropertiesAbridged",
  • "modifier_set": "string"
}

Roughness

string (Roughness)
Enum: "VeryRough" "Rough" "MediumRough" "MediumSmooth" "Smooth" "VerySmooth"

Relative roughness of a particular material layer.

"VeryRough"

ScheduleDay

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
values
required
Array of numbers <double> (Values)

A list of floats or integers for the values of the schedule. The length of this list must match the length of the times list.

times
Array of Array of integers (Times)
Default: [0,0]

A list of lists with each sub-list possesing 2 values for [hour, minute]. The length of the master list must match the length of the values list. Each time in the master list represents the time of day that the corresponding value begins to take effect. For example [(0,0), (9,0), (17,0)] in combination with the values [0, 1, 0] denotes a schedule value of 0 from 0:00 to 9:00, a value of 1 from 9:00 to 17:00 and 0 from 17:00 to the end of the day. Note that this representation of times as the "time of beginning" is a different convention than EnergyPlus, which uses "time until".

interpolate
boolean (Interpolate)
Default: false

Boolean to note whether values in between times should be linearly interpolated or whether successive values should take effect immediately upon the beginning time corresponding to them.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "ScheduleDay",
  • "values":
    [
    ],
  • "times":
    [
    ],
  • "interpolate": false
}

ScheduleFixedInterval

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
values
required
Array of numbers <double> (Values) [ 24 .. 527040 ] items

A list of timeseries values occuring at each timestep over the course of the simulation.

schedule_type_limit
object (Schedule Type Limit) Recursive

ScheduleTypeLimit object that will be used to validate schedule values against upper/lower limits and assign units to the schedule values. If None, no validation will occur.

timestep
integer <int32> (Timestep)
Default: 1

An integer for the number of steps per hour that the input values correspond to. For example, if each value represents 30 minutes, the timestep is 2. For 15 minutes, it is 4.

start_date
Array of integers <int32> (Start Date) [ 2 .. 3 ] items
Default: [1,1]

A list of two integers for [month, day], representing the start date when the schedule values begin to take effect.A third integer may be added to denote whether the date should be re-serialized for a leap year (it should be a 1 in this case).

placeholder_value
number <double> (Placeholder Value)
Default: 0

A value that will be used for all times not covered by the input values. Typically, your simulation should not need to use this value if the input values completely cover the simulation period.

interpolate
boolean (Interpolate)
Default: false

Boolean to note whether values in between intervals should be linearly interpolated or whether successive values should take effect immediately upon the beginning time corresponding to them.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "ScheduleFixedInterval",
  • "values":
    [
    ],
  • "schedule_type_limit":
    {
    },
  • "timestep": 1,
  • "start_date":
    [
    ],
  • "placeholder_value": 0,
  • "interpolate": false
}

ScheduleFixedIntervalAbridged

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
values
required
Array of numbers <double> (Values) [ 24 .. 527040 ] items

A list of timeseries values occuring at each timestep over the course of the simulation.

schedule_type_limit
string (Schedule Type Limit) [ 1 .. 100 ] characters

Identifier of a ScheduleTypeLimit that will be used to validate schedule values against upper/lower limits and assign units to the schedule values. If None, no validation will occur.

timestep
integer <int32> (Timestep)
Default: 1

An integer for the number of steps per hour that the input values correspond to. For example, if each value represents 30 minutes, the timestep is 2. For 15 minutes, it is 4.

start_date
Array of integers <int32> (Start Date) [ 2 .. 3 ] items
Default: [1,1]

A list of two integers for [month, day], representing the start date when the schedule values begin to take effect.A third integer may be added to denote whether the date should be re-serialized for a leap year (it should be a 1 in this case).

placeholder_value
number <double> (Placeholder Value)
Default: 0

A value that will be used for all times not covered by the input values. Typically, your simulation should not need to use this value if the input values completely cover the simulation period.

interpolate
boolean (Interpolate)
Default: false

Boolean to note whether values in between intervals should be linearly interpolated or whether successive values should take effect immediately upon the beginning time corresponding to them.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "ScheduleFixedIntervalAbridged",
  • "values":
    [
    ],
  • "schedule_type_limit": "string",
  • "timestep": 1,
  • "start_date":
    [
    ],
  • "placeholder_value": 0,
  • "interpolate": false
}

ScheduleNumericType

string (ScheduleNumericType)
Enum: "Continuous" "Discrete"

Designates how the range values are validated.

"Continuous"

ScheduleRuleAbridged

type
string ^DatedBaseModel$
Default: "DatedBaseModel"
schedule_day
required
string (Schedule Day) [ 1 .. 100 ] characters

The identifier of a ScheduleDay object associated with this rule.

apply_sunday
boolean (Apply Sunday)
Default: false

Boolean noting whether to apply schedule_day on Sundays.

apply_monday
boolean (Apply Monday)
Default: false

Boolean noting whether to apply schedule_day on Mondays.

apply_tuesday
boolean (Apply Tuesday)
Default: false

Boolean noting whether to apply schedule_day on Tuesdays.

apply_wednesday
boolean (Apply Wednesday)
Default: false

Boolean noting whether to apply schedule_day on Wednesdays.

apply_thursday
boolean (Apply Thursday)
Default: false

Boolean noting whether to apply schedule_day on Thursdays.

apply_friday
boolean (Apply Friday)
Default: false

Boolean noting whether to apply schedule_day on Fridays.

apply_saturday
boolean (Apply Saturday)
Default: false

Boolean noting whether to apply schedule_day on Saturdays.

start_date
Array of integers <int32> (Start Date) [ 2 .. 3 ] items
Default: [1,1]

A list of two integers for [month, day], representing the start date of the period over which the schedule_day will be applied.A third integer may be added to denote whether the date should be re-serialized for a leap year (it should be a 1 in this case).

end_date
Array of integers <int32> (End Date) [ 2 .. 3 ] items
Default: [12,31]

A list of two integers for [month, day], representing the end date of the period over which the schedule_day will be applied.A third integer may be added to denote whether the date should be re-serialized for a leap year (it should be a 1 in this case).

{
  • "type": "ScheduleRuleAbridged",
  • "schedule_day": "string",
  • "apply_sunday": false,
  • "apply_monday": false,
  • "apply_tuesday": false,
  • "apply_wednesday": false,
  • "apply_thursday": false,
  • "apply_friday": false,
  • "apply_saturday": false,
  • "start_date":
    [
    ],
  • "end_date":
    [
    ]
}

ScheduleRuleset

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
required
Array of objects (Day Schedules)

A list of ScheduleDays that are referenced in the other keys of this ScheduleRulesetAbridged.

default_day_schedule
required
string (Default Day Schedule) [ 1 .. 100 ] characters

An identifier for the ScheduleDay that will be used for all days when no ScheduleRule is applied. This ScheduleDay must be in the day_schedules.

Array of objects (Schedule Rules)

A list of ScheduleRuleAbridged that note exceptions to the default_day_schedule. These rules should be ordered from highest to lowest priority.

holiday_schedule
string (Holiday Schedule) [ 1 .. 100 ] characters

An identifier for the ScheduleDay that will be used for holidays. This ScheduleDay must be in the day_schedules.

summer_designday_schedule
string (Summer Designday Schedule) [ 1 .. 100 ] characters

An identifier for the ScheduleDay that will be used for the summer design day. This ScheduleDay must be in the day_schedules.

winter_designday_schedule
string (Winter Designday Schedule) [ 1 .. 100 ] characters

An identifier for the ScheduleDay that will be used for the winter design day. This ScheduleDay must be in the day_schedules.

schedule_type_limit
object (Schedule Type Limit) Recursive

ScheduleTypeLimit object that will be used to validate schedule values against upper/lower limits and assign units to the schedule values. If None, no validation will occur.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "ScheduleRuleset",
  • "day_schedules":
    [
    ],
  • "default_day_schedule": "string",
  • "schedule_rules":
    [
    ],
  • "holiday_schedule": "string",
  • "summer_designday_schedule": "string",
  • "winter_designday_schedule": "string",
  • "schedule_type_limit":
    {
    }
}

ScheduleRulesetAbridged

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
required
Array of objects (Day Schedules)

A list of ScheduleDays that are referenced in the other keys of this ScheduleRulesetAbridged.

default_day_schedule
required
string (Default Day Schedule) [ 1 .. 100 ] characters

An identifier for the ScheduleDay that will be used for all days when no ScheduleRule is applied. This ScheduleDay must be in the day_schedules.

Array of objects (Schedule Rules)

A list of ScheduleRuleAbridged that note exceptions to the default_day_schedule. These rules should be ordered from highest to lowest priority.

holiday_schedule
string (Holiday Schedule) [ 1 .. 100 ] characters

An identifier for the ScheduleDay that will be used for holidays. This ScheduleDay must be in the day_schedules.

summer_designday_schedule
string (Summer Designday Schedule) [ 1 .. 100 ] characters

An identifier for the ScheduleDay that will be used for the summer design day. This ScheduleDay must be in the day_schedules.

winter_designday_schedule
string (Winter Designday Schedule) [ 1 .. 100 ] characters

An identifier for the ScheduleDay that will be used for the winter design day. This ScheduleDay must be in the day_schedules.

schedule_type_limit
string (Schedule Type Limit) [ 1 .. 100 ] characters

Identifier of a ScheduleTypeLimit that will be used to validate schedule values against upper/lower limits and assign units to the schedule values. If None, no validation will occur.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "ScheduleRulesetAbridged",
  • "day_schedules":
    [
    ],
  • "default_day_schedule": "string",
  • "schedule_rules":
    [
    ],
  • "holiday_schedule": "string",
  • "summer_designday_schedule": "string",
  • "winter_designday_schedule": "string",
  • "schedule_type_limit": "string"
}

ScheduleTypeLimit

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
NoLimit (object) or number (Lower Limit)
Default: {"type":"NoLimit"}

Lower limit for the schedule type or NoLimit.

NoLimit (object) or number (Upper Limit)
Default: {"type":"NoLimit"}

Upper limit for the schedule type or NoLimit.

numeric_type
string (ScheduleNumericType)
Enum: "Continuous" "Discrete"

Designates how the range values are validated.

unit_type
string (ScheduleUnitType)
Enum: "Dimensionless" "Temperature" "DeltaTemperature" "PrecipitationRate" "Angle" "ConvectionCoefficient" "ActivityLevel" "Velocity" "Capacity" "Power" "Availability" "Percent" "Control" "Mode"

An enumeration.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "ScheduleTypeLimit",
  • "lower_limit":
    {
    },
  • "upper_limit":
    {
    },
  • "numeric_type": "Continuous",
  • "unit_type": "Dimensionless"
}

ScheduleUnitType

string (ScheduleUnitType)
Enum: "Dimensionless" "Temperature" "DeltaTemperature" "PrecipitationRate" "Angle" "ConvectionCoefficient" "ActivityLevel" "Velocity" "Capacity" "Power" "Availability" "Percent" "Control" "Mode"

An enumeration.

"Dimensionless"

Sensor

pos
required
Array of numbers <double> (Pos) 3 items

Position of sensor in space as an array of (x, y, z) values.

dir
required
Array of numbers <double> (Dir) 3 items

Direction of sensor as an array of (x, y, z) values.

type
string (Type) ^Sensor$
Default: "Sensor"
{
  • "pos":
    [
    ],
  • "dir":
    [
    ],
  • "type": "Sensor"
}

SensorGrid

identifier
required
string (Identifier)

Text string for a unique Radiance object. Must not contain spaces or special characters. This will be used to identify the object across a model and in the exported Radiance files.

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdRadianceBaseModel$
Default: "IDdRadianceBaseModel"
room_identifier
string (Room Identifier) [ 1 .. 100 ] characters [A-Za-z0-9_-]

Optional text string for the Room identifier to which this object belongs. This will be used to narrow down the number of aperture groups that have to be run with this sensor grid. If None, the grid will be run with all aperture groups in the model.

light_path
Array of Array of strings (Light Path)

Get or set a list of lists for the light path from the object to the sky. Each sub-list contains identifiers of aperture groups through which light passes. (eg. [["SouthWindow1"], ["static_apertures", "NorthWindow2"]]).Setting this property will override any auto-calculation of the light path from the model and room_identifier upon export to the simulation.

required
Array of objects (Sensors)

A list of sensors that belong to the grid.

object (Mesh)

An optional Mesh3D that aligns with the sensors and can be used for visualization of the grid. Note that the number of sensors in the grid must match the number of faces or the number vertices within the Mesh3D.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "SensorGrid",
  • "room_identifier": "string",
  • "light_path":
    [
    ],
  • "sensors":
    [
    ],
  • "mesh":
    {
    }
}

Setpoint

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
required
ScheduleRuleset (object) or ScheduleFixedInterval (object) (Cooling Schedule)

Schedule for the cooling setpoint. The values in this schedule should be temperature in [C].

required
ScheduleRuleset (object) or ScheduleFixedInterval (object) (Heating Schedule)

Schedule for the heating setpoint. The values in this schedule should be temperature in [C].

ScheduleRuleset (object) or ScheduleFixedInterval (object) (Humidifying Schedule)

Schedule for the humidification setpoint. The values in this schedule should be in [%].

ScheduleRuleset (object) or ScheduleFixedInterval (object) (Dehumidifying Schedule)

Schedule for the dehumidification setpoint. The values in this schedule should be in [%].

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "Setpoint",
  • "cooling_schedule":
    {
    },
  • "heating_schedule":
    {
    },
  • "humidifying_schedule":
    {
    },
  • "dehumidifying_schedule":
    {
    }
}

SetpointAbridged

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
cooling_schedule
required
string (Cooling Schedule) [ 1 .. 100 ] characters

Identifier of the schedule for the cooling setpoint. The values in this schedule should be temperature in [C].

heating_schedule
required
string (Heating Schedule) [ 1 .. 100 ] characters

Identifier of the schedule for the heating setpoint. The values in this schedule should be temperature in [C].

humidifying_schedule
string (Humidifying Schedule) [ 1 .. 100 ] characters

Identifier of the schedule for the humidification setpoint. The values in this schedule should be in [%].

dehumidifying_schedule
string (Dehumidifying Schedule) [ 1 .. 100 ] characters

Identifier of the schedule for the dehumidification setpoint. The values in this schedule should be in [%].

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "SetpointAbridged",
  • "cooling_schedule": "string",
  • "heating_schedule": "string",
  • "humidifying_schedule": "string",
  • "dehumidifying_schedule": "string"
}

Shade

identifier
required
string (Identifier) [ 1 .. 100 ] characters [A-Za-z0-9_-]

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, rad). This identifier is also used to reference the object across a Model. It must be < 100 characters and not contain any spaces or special characters.

display_name
string (Display Name)

Display name of the object with no character restrictions.

user_data
object (User Data)

Optional dictionary of user data associated with the object.All keys and values of this dictionary should be of a standard data type to ensure correct serialization of the object (eg. str, float, int, list).

type
string ^IDdBaseModel$
Default: "IDdBaseModel"
required
object (Geometry)

Planar Face3D for the geometry.

required
object (Properties)

Extension properties for particular simulation engines (Radiance, EnergyPlus).

is_detached
boolean (Is Detached)
Default: false

Boolean to note whether this shade is detached from any of the other geometry in the model. Cases where this should be True include shade representing surrounding buildings or context. Note that this should always be False for shades assigned to parent objects.

{
  • "identifier": "string",
  • "display_name": "string",
  • "user_data": { },
  • "type": "Shade",
  • "geometry":
    {
    },
  • "properties":
    {
    },
  • "is_detached": false
}

ShadeConstruction

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
solar_reflectance
number <double> (Solar Reflectance) [ 0 .. 1 ]
Default: 0.2

A number for the solar reflectance of the construction.

visible_reflectance
number <double> (Visible Reflectance) [ 0 .. 1 ]
Default: 0.2

A number for the visible reflectance of the construction.

is_specular
boolean (Is Specular)
Default: false

Boolean to note whether the reflection off the shade is diffuse (False) or specular (True). Set to True if the construction is representing a glass facade or a mirror material.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "ShadeConstruction",
  • "solar_reflectance": 0.2,
  • "visible_reflectance": 0.2,
  • "is_specular": false
}

ShadeEnergyPropertiesAbridged

type
string (Type) ^ShadeEnergyPropertiesAbridged$
Default: "ShadeEnergyPropertiesAbridged"
construction
string (Construction) [ 1 .. 100 ] characters

Identifier of a ShadeConstruction to set the reflectance and specularity of the Shade. If None, the construction is set by theparent Room construction_set, the Model global_construction_set or (in the case fo an orphaned shade) the EnergyPlus default of 0.2 diffuse reflectance.

transmittance_schedule
string (Transmittance Schedule) [ 1 .. 100 ] characters

Identifier of a schedule to set the transmittance of the shade, which can vary throughout the simulation. If None, the shade will be completely opaque.

{
  • "type": "ShadeEnergyPropertiesAbridged",
  • "construction": "string",
  • "transmittance_schedule": "string"
}

ShadeLocation

string (ShadeLocation)
Enum: "Interior" "Between" "Exterior"

Choices for where a shade material is located in a window assembly.

"Interior"

ShadeModifierSet

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Exterior Modifier)

A radiance modifier object for faces with an Outdoors boundary condition.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Interior Modifier)

A radiance modifier object for faces with a boundary condition other than Outdoors.

type
string (Type) ^ShadeModifierSet$
Default: "ShadeModifierSet"
{
  • "exterior_modifier":
    {
    },
  • "interior_modifier":
    {
    },
  • "type": "ShadeModifierSet"
}

ShadeModifierSetAbridged

exterior_modifier
string (Exterior Modifier)

Identifier for a radiance modifier object for faces with an Outdoors boundary condition.

interior_modifier
string (Interior Modifier)

Identifier for a radiance modifier object for faces with a boundary condition other than Outdoors.

type
string ^BaseModifierSetAbridged$
Default: "BaseModifierSetAbridged"
{
  • "exterior_modifier": "string",
  • "interior_modifier": "string",
  • "type": "ShadeModifierSetAbridged"
}

ShadePropertiesAbridged

type
string (Type) ^ShadePropertiesAbridged$
Default: "ShadePropertiesAbridged"
object (ShadeEnergyPropertiesAbridged)

Base class for all objects that are not extensible with additional keys.

This effectively includes all objects except for the Properties classes that are assigned to geometry objects.

object (ShadeRadiancePropertiesAbridged)

Radiance Properties for Honeybee Shade Abridged.

{
  • "type": "ShadePropertiesAbridged",
  • "energy":
    {
    },
  • "radiance":
    {
    }
}

ShadeRadiancePropertiesAbridged

modifier
string (Modifier)

A string for a Honeybee Radiance Modifier (default: None).

modifier_blk
string (Modifier Blk)

A string for a Honeybee Radiance Modifier to be used in direct solar simulations and in isolation studies (assessingthe contribution of individual objects) (default: None).

type
string ^_PropertiesBaseAbridged$
Default: "_PropertiesBaseAbridged"
dynamic_group_identifier
string (Dynamic Group Identifier)

An optional string to note the dynamic group ' 'to which the Shade is a part of. Shades sharing the same ' 'dynamic_group_identifier will have their states change in unison. ' 'If None, the Shade is assumed to be static. (default: None).

Array of objects (States)

An optional list of abridged states (default: None).

{
  • "modifier": "string",
  • "modifier_blk": "string",
  • "type": "ShadeRadiancePropertiesAbridged",
  • "dynamic_group_identifier": "string",
  • "states":
    [
    ]
}

SlatOrientation

string (SlatOrientation)
Enum: "Horizontal" "Vertical"

An enumeration.

"Horizontal"

StateGeometryAbridged

identifier
required
string (Identifier)

Text string for a unique Radiance object. Must not contain spaces or special characters. This will be used to identify the object across a model and in the exported Radiance files.

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdRadianceBaseModel$
Default: "IDdRadianceBaseModel"
required
object (Geometry)

A ladybug_geometry Face3D.

modifier
string (Modifier)

A string for a Honeybee Radiance Modifier identifier (default: None).

modifier_direct
string (Modifier Direct)

A string for Honeybee Radiance Modifier identifiers to be used in direct solar simulations and in isolation studies (assessingthe contribution of individual objects) (default: None).

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "StateGeometryAbridged",
  • "geometry":
    {
    },
  • "modifier": "string",
  • "modifier_direct": "string"
}

Surface

boundary_condition_objects
required
Array of strings (Boundary Condition Objects) [ 2 .. 3 ] items

A list of up to 3 object identifiers that are adjacent to this one. The first object is always the one that is immediately adjacent and is of the same object type (Face, Aperture, Door). When this boundary condition is applied to a Face, the second object in the tuple will be the parent Room of the adjacent object. When the boundary condition is applied to a sub-face (Door or Aperture), the second object will be the parent Face of the adjacent sub-face and the third object will be the parent Room of the adjacent sub-face.

type
string (Type) ^Surface$
Default: "Surface"
{
  • "boundary_condition_objects":
    [
    ],
  • "type": "Surface"
}

Trans

identifier
required
string (Identifier)

Text string for a unique Radiance object. Must not contain spaces or special characters. This will be used to identify the object across a model and in the exported Radiance files.

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdRadianceBaseModel$
Default: "IDdRadianceBaseModel"
Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Modifier)
Default: {"type":"void"}

Material modifier (default: Void).

Array of Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Dependencies)

List of modifiers that this modifier depends on. This argument is only useful for defining advanced modifiers where the modifier is defined based on other modifiers (default: None).

r_reflectance
number <double> (R Reflectance) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the red channel reflectance (default: 0).

g_reflectance
number <double> (G Reflectance) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the green channel reflectance (default: 0).

b_reflectance
number <double> (B Reflectance) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the blue channel reflectance (default: 0).

specularity
number <double> (Specularity) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the fraction of specularity. Specularity fractions greater than 0.1 are not realistic for non-metallic materials. (default: 0).

roughness
number <double> (Roughness) [ 0 .. 1 ]
Default: 0

A value between 0 and 1 for the roughness, specified as the rms slope of surface facets. Roughness greater than 0.2 are not realistic (default: 0).

transmitted_diff
number <double> (Transmitted Diff) [ 0 .. 1 ]
Default: 0

The fraction of transmitted light that is transmitted diffusely in a scattering fashion (default: 0).

transmitted_spec
number <double> (Transmitted Spec) [ 0 .. 1 ]
Default: 0

The fraction of transmitted light that is not diffusely scattered (default: 0).

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "trans",
  • "modifier":
    {
    },
  • "dependencies":
    [
    ],
  • "r_reflectance": 0,
  • "g_reflectance": 0,
  • "b_reflectance": 0,
  • "specularity": 0,
  • "roughness": 0,
  • "transmitted_diff": 0,
  • "transmitted_spec": 0
}

Units

string (Units)
Enum: "Meters" "Millimeters" "Feet" "Inches" "Centimeters"

An enumeration.

"Meters"

VAV

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
vintage
string (Vintages)
Enum: "90.1-2013" "90.1-2010" "90.1-2007" "90.1-2004" "DOE Ref 1980-2004" "DOE Ref Pre-1980"

An enumeration.

economizer_type
string (AllAirEconomizerType)
Enum: "Inferred" "NoEconomizer" "DifferentialDryBulb" "DifferentialEnthalpy"

An enumeration.

Autosize (object) or number (Sensible Heat Recovery)
Default: {"type":"Autosize"}

A number between 0 and 1 for the effectiveness of sensible heat recovery within the system. If None or Autosize, it will be whatever is recommended for the given vintage.

Autosize (object) or number (Latent Heat Recovery)
Default: {"type":"Autosize"}

A number between 0 and 1 for the effectiveness of latent heat recovery within the system. If None or Autosize, it will be whatever is recommended for the given vintage.

equipment_type
string (VAVEquipmentType)
Enum: "VAV chiller with gas boiler reheat" "VAV chiller with central air source heat pump reheat" "VAV chiller with district hot water reheat" "VAV chiller with PFP boxes" "VAV chiller with gas coil reheat" "VAV air-cooled chiller with gas boiler reheat" "VAV air-cooled chiller with central air source heat pump reheat" "VAV air-cooled chiller with district hot water reheat" "VAV air-cooled chiller with PFP boxes" "VAV air-cooled chiller with gas coil reheat" "VAV district chilled water with gas boiler reheat" "VAV district chilled water with central air source heat pump reheat" "VAV district chilled water with district hot water reheat" "VAV district chilled water with PFP boxes" "VAV district chilled water with gas coil reheat"

An enumeration.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "VAV",
  • "vintage": "90.1-2013",
  • "economizer_type": "Inferred",
  • "sensible_heat_recovery":
    {
    },
  • "latent_heat_recovery":
    {
    },
  • "equipment_type": "VAV chiller with gas boiler reheat"
}

VAVEquipmentType

string (VAVEquipmentType)
Enum: "VAV chiller with gas boiler reheat" "VAV chiller with central air source heat pump reheat" "VAV chiller with district hot water reheat" "VAV chiller with PFP boxes" "VAV chiller with gas coil reheat" "VAV air-cooled chiller with gas boiler reheat" "VAV air-cooled chiller with central air source heat pump reheat" "VAV air-cooled chiller with district hot water reheat" "VAV air-cooled chiller with PFP boxes" "VAV air-cooled chiller with gas coil reheat" "VAV district chilled water with gas boiler reheat" "VAV district chilled water with central air source heat pump reheat" "VAV district chilled water with district hot water reheat" "VAV district chilled water with PFP boxes" "VAV district chilled water with gas coil reheat"

An enumeration.

"VAV chiller with gas boiler reheat"

Ventilation

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
flow_per_person
number <double> (Flow Per Person) >= 0
Default: 0

Intensity of ventilation in[] m3/s per person]. Note that setting this value does not mean that ventilation is varied based on real-time occupancy but rather that the design level of ventilation is determined using this value and the People object of the Room.

flow_per_area
number <double> (Flow Per Area) >= 0
Default: 0

Intensity of ventilation in [m3/s per m2 of floor area].

air_changes_per_hour
number <double> (Air Changes Per Hour) >= 0
Default: 0

Intensity of ventilation in air changes per hour (ACH) for the entire Room.

flow_per_zone
number <double> (Flow Per Zone) >= 0
Default: 0

Intensity of ventilation in m3/s for the entire Room.

ScheduleRuleset (object) or ScheduleFixedInterval (object) (Schedule)

Schedule for the ventilation over the course of the year. The type of this schedule should be Fractional and the fractional values will get multiplied by the total design flow rate (determined from the sum of the other 4 fields) to yield a complete ventilation profile.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "Ventilation",
  • "flow_per_person": 0,
  • "flow_per_area": 0,
  • "air_changes_per_hour": 0,
  • "flow_per_zone": 0,
  • "schedule":
    {
    }
}

VentilationAbridged

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
flow_per_person
number <double> (Flow Per Person) >= 0
Default: 0

Intensity of ventilation in[] m3/s per person]. Note that setting this value does not mean that ventilation is varied based on real-time occupancy but rather that the design level of ventilation is determined using this value and the People object of the Room.

flow_per_area
number <double> (Flow Per Area) >= 0
Default: 0

Intensity of ventilation in [m3/s per m2 of floor area].

air_changes_per_hour
number <double> (Air Changes Per Hour) >= 0
Default: 0

Intensity of ventilation in air changes per hour (ACH) for the entire Room.

flow_per_zone
number <double> (Flow Per Zone) >= 0
Default: 0

Intensity of ventilation in m3/s for the entire Room.

schedule
string (Schedule) [ 1 .. 100 ] characters

Identifier of the schedule for the ventilation over the course of the year. The type of this schedule should be Fractional and the fractional values will get multiplied by the total design flow rate (determined from the sum of the other 4 fields) to yield a complete ventilation profile.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "VentilationAbridged",
  • "flow_per_person": 0,
  • "flow_per_area": 0,
  • "air_changes_per_hour": 0,
  • "flow_per_zone": 0,
  • "schedule": "string"
}

VentilationControlAbridged

type
string (Type) ^VentilationControlAbridged$
Default: "VentilationControlAbridged"
min_indoor_temperature
number <double> (Min Indoor Temperature) [ -100 .. 100 ]
Default: -100

A number for the minimum indoor temperature at which to ventilate in Celsius. Typically, this variable is used to initiate ventilation.

max_indoor_temperature
number <double> (Max Indoor Temperature) [ -100 .. 100 ]
Default: 100

A number for the maximum indoor temperature at which to ventilate in Celsius. This can be used to set a maximum temperature at which point ventilation is stopped and a cooling system is turned on.

min_outdoor_temperature
number <double> (Min Outdoor Temperature) [ -100 .. 100 ]
Default: -100

A number for the minimum outdoor temperature at which to ventilate in Celsius. This can be used to ensure ventilative cooling does not happen during the winter even if the Room is above the min_indoor_temperature.

max_outdoor_temperature
number <double> (Max Outdoor Temperature) [ -100 .. 100 ]
Default: 100

A number for the maximum indoor temperature at which to ventilate in Celsius. This can be used to set a limit for when it is considered too hot outside for ventilative cooling.

delta_temperature
number <double> (Delta Temperature) [ -100 .. 100 ]
Default: -100

A number for the temperature differential in Celsius between indoor and outdoor below which ventilation is shut off. This should usually be a positive number so that ventilation only occurs when the outdoors is cooler than the indoors. Negative numbers indicate how much hotter the outdoors can be than the indoors before ventilation is stopped.

schedule
string (Schedule) [ 1 .. 100 ] characters

Identifier of the schedule for the ventilation over the course of the year. Note that this is applied on top of any setpoints. The type of this schedule should be On/Off and values should be either 0 (no possibility of ventilation) or 1 (ventilation possible).

{
  • "type": "VentilationControlAbridged",
  • "min_indoor_temperature": -100,
  • "max_indoor_temperature": 100,
  • "min_outdoor_temperature": -100,
  • "max_outdoor_temperature": 100,
  • "delta_temperature": -100,
  • "schedule": "string"
}

VentilationControlType

string (VentilationControlType)
Enum: "SingleZone" "MultiZoneWithDistribution" "MultiZoneWithoutDistribution"

An enumeration.

"SingleZone"

VentilationOpening

type
string (Type) ^VentilationOpening$
Default: "VentilationOpening"
fraction_area_operable
number <double> (Fraction Area Operable) [ 0 .. 1 ]
Default: 0.5

A number for the fraction of the window area that is operable.

fraction_height_operable
number <double> (Fraction Height Operable) [ 0 .. 1 ]
Default: 1

A number for the fraction of the distance from the bottom of the window to the top that is operable

discharge_coefficient
number <double> (Discharge Coefficient) [ 0 .. 1 ]
Default: 0.45

A number that will be multipled by the area of the window in the stack (buoyancy-driven) part of the equation to account for additional friction from window geometry, insect screens, etc. Typical values include 0.45, for unobstructed windows WITH insect screens and 0.65 for unobstructed windows WITHOUT insect screens. This value should be lowered if windows are of an awning or casement type and are not allowed to fully open.

wind_cross_vent
boolean (Wind Cross Vent)
Default: false

Boolean to indicate if there is an opening of roughly equal area on the opposite side of the Room such that wind-driven cross ventilation will be induced. If False, the assumption is that the operable area is primarily on one side of the Room and there is no wind-driven ventilation.

flow_coefficient_closed
number <double> (Flow Coefficient Closed) >= 0

An optional number in kg/s-m, at 1 Pa per meter of crack length, used to calculate the mass flow rate when the opening is closed; required to run an AirflowNetwork simulation. The DesignBuilder Cracks template defines the flow coefficient for a tight, low-leakage closed external window to be 0.00001, and the flow coefficient for a very poor, high-leakage closed external window to be 0.003.

flow_exponent_closed
number <double> (Flow Exponent Closed) [ 0.5 .. 1 ]
Default: 0.65

An optional dimensionless number between 0.5 and 1 used to calculate the mass flow rate when the opening is closed; required to run an AirflowNetwork simulation. This value represents the leak geometry impact on airflow, with 0.5 generally corresponding to turbulent orifice flow and 1 generally corresponding to laminar flow. The default of 0.65 is representative of many cases of wall and window leakage, used when the exponent cannot be measured.

two_way_threshold
number <double> (Two Way Threshold)
Default: 0.0001

A number in kg/m3 indicating the minimum density difference above which two-way flow may occur due to stack effect, required to run an AirflowNetwork simulation. This value is required because the air density difference between two zones (which drives two-way air flow) will tend towards division by zero errors as the air density difference approaches zero. The default of 0.0001 is a typical default value used for AirflowNetwork openings.

{
  • "type": "VentilationOpening",
  • "fraction_area_operable": 0.5,
  • "fraction_height_operable": 1,
  • "discharge_coefficient": 0.45,
  • "wind_cross_vent": false,
  • "flow_coefficient_closed": 0,
  • "flow_exponent_closed": 0.65,
  • "two_way_threshold": 0.0001
}

VentilationSimulationControl

type
string (Type) ^VentilationSimulationControl$
Default: "VentilationSimulationControl"
vent_control_type
string (VentilationControlType)
Enum: "SingleZone" "MultiZoneWithDistribution" "MultiZoneWithoutDistribution"

An enumeration.

reference_temperature
number <double> (Reference Temperature) >= -273.15
Default: 20

Reference temperature measurement in Celsius under which the surface crack data were obtained.

reference_pressure
number <double> (Reference Pressure) [ 31000 .. 120000 ]
Default: 101325

Reference barometric pressure measurement in Pascals under which the surface crack data were obtained.

reference_humidity_ratio
number <double> (Reference Humidity Ratio) >= 0
Default: 0

Reference humidity ratio measurement in kgWater/kgDryAir under which the surface crack data were obtained.

building_type
string (BuildingType)
Enum: "LowRise" "HighRise"

An enumeration.

long_axis_angle
number <double> (Long Axis Angle) [ 0 .. 180 ]
Default: 0

The clockwise rotation in degrees from true North of the long axis of the building. This parameter is required to automatically calculate wind pressure coefficients for the AirflowNetwork simulation. If used for complex building geometries that cannot be described as a highrise or lowrise rectangular mass, the resulting air flow and pressure simulated on the building surfaces may be inaccurate.

aspect_ratio
number <double> (Aspect Ratio) <= 1
Default: 1

Aspect ratio of a rectangular footprint, defined as the ratio of length of the short axis divided by the length of the long axis. This parameter is required to automatically calculate wind pressure coefficients for the AirflowNetwork simulation. If used for complex building geometries that cannot be described as a highrise or lowrise rectangular mass, the resulting air flow and pressure simulated on the building surfaces may be inaccurate.

{
  • "type": "VentilationSimulationControl",
  • "vent_control_type": "SingleZone",
  • "reference_temperature": 20,
  • "reference_pressure": 101325,
  • "reference_humidity_ratio": 0,
  • "building_type": "LowRise",
  • "long_axis_angle": 0,
  • "aspect_ratio": 1
}

View

identifier
required
string (Identifier)

Text string for a unique Radiance object. Must not contain spaces or special characters. This will be used to identify the object across a model and in the exported Radiance files.

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdRadianceBaseModel$
Default: "IDdRadianceBaseModel"
room_identifier
string (Room Identifier) [ 1 .. 100 ] characters [A-Za-z0-9_-]

Optional text string for the Room identifier to which this object belongs. This will be used to narrow down the number of aperture groups that have to be run with this sensor grid. If None, the grid will be run with all aperture groups in the model.

light_path
Array of Array of strings (Light Path)

Get or set a list of lists for the light path from the object to the sky. Each sub-list contains identifiers of aperture groups through which light passes. (eg. [["SouthWindow1"], ["static_apertures", "NorthWindow2"]]).Setting this property will override any auto-calculation of the light path from the model and room_identifier upon export to the simulation.

position
required
Array of numbers <double> (Position) 3 items

The view position (-vp) as an array of (x, y, z) values.This is the focal point of a perspective view or the center of a parallel projection.

direction
required
Array of numbers <double> (Direction) 3 items

The view direction (-vd) as an array of (x, y, z) values.The length of this vector indicates the focal distance as needed by the pixel depth of field (-pd) in rpict.

up_vector
required
Array of numbers <double> (Up Vector) 3 items

The view up (-vu) vector as an array of (x, y, z) values.

view_type
string (ViewType)
Enum: "v" "h" "l" "c" "a" "s"

A single character for the view type (-vt).

h_size
number <double> (H Size)
Default: 60

A number for the horizontal field of view in degrees (for all perspective projections including fisheye). For a parallel projection, this is the view width in world coordinates.

v_size
number <double> (V Size)
Default: 60

A number for the vertical field of view in degrees (for all perspective projections including fisheye). For a parallel projection, this is the view width in world coordinates.

shift
number <double> (Shift)

The view shift (-vs). This is the amount the actual image will be shifted to the right of the specified view. This option is useful for generating skewed perspectives or rendering an image a piece at a time. A value of 1 means that the rendered image starts just to the right of the normal view. A value of -1 would be to the left. Larger or fractional values are permitted as well.

lift
number <double> (Lift)

The view lift (-vl). This is the amount the actual image will be lifted up from the specified view. This option is useful for generating skewed perspectives or rendering an image a piece at a time. A value of 1 means that the rendered image starts just to the right of the normal view. A value of -1 would be to the left. Larger or fractional values are permitted as well.

fore_clip
number <double> (Fore Clip)

View fore clip (-vo) at a distance from the view point.The plane will be perpendicular to the view direction for perspective and parallel view types. For fisheye view types, the clipping plane is actually a clipping sphere, centered on the view point with fore_clip radius. Objects in front of this imaginary surface will not be visible.

aft_clip
number <double> (Aft Clip)

View aft clip (-va) at a distance from the view point.Like the view fore plane, it will be perpendicular to the view direction for perspective and parallel view types. For fisheye view types, the clipping plane is actually a clipping sphere, centered on the view point with radius val.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "View",
  • "room_identifier": "string",
  • "light_path":
    [
    ],
  • "position":
    [
    ],
  • "direction":
    [
    ],
  • "up_vector":
    [
    ],
  • "view_type": "v",
  • "h_size": 60,
  • "v_size": 60,
  • "shift": 0,
  • "lift": 0,
  • "fore_clip": 0,
  • "aft_clip": 0
}

ViewType

string (ViewType)
Enum: "v" "h" "l" "c" "a" "s"

A single character for the view type (-vt).

"v"

Vintages

string (Vintages)
Enum: "90.1-2013" "90.1-2010" "90.1-2007" "90.1-2004" "DOE Ref 1980-2004" "DOE Ref Pre-1980"

An enumeration.

"90.1-2013"

Void

type
string (Type) ^void$
Default: "void"
{
  • "type": "void"
}

VRF

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
vintage
string (Vintages)
Enum: "90.1-2013" "90.1-2010" "90.1-2007" "90.1-2004" "DOE Ref 1980-2004" "DOE Ref Pre-1980"

An enumeration.

equipment_type
string (VRFEquipmentType)
Value: "VRF"

An enumeration.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "VRF",
  • "vintage": "90.1-2013",
  • "equipment_type": "VRF"
}

VRFEquipmentType

string (VRFEquipmentType)
Value: "VRF"

An enumeration.

"VRF"

VRFwithDOAS

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
vintage
string (Vintages)
Enum: "90.1-2013" "90.1-2010" "90.1-2007" "90.1-2004" "DOE Ref 1980-2004" "DOE Ref Pre-1980"

An enumeration.

Autosize (object) or number (Sensible Heat Recovery)
Default: {"type":"Autosize"}

A number between 0 and 1 for the effectiveness of sensible heat recovery within the system. If None or Autosize, it will be whatever is recommended for the given vintage.

Autosize (object) or number (Latent Heat Recovery)
Default: {"type":"Autosize"}

A number between 0 and 1 for the effectiveness of latent heat recovery within the system. If None or Autosize, it will be whatever is recommended for the given vintage.

equipment_type
string (VRFwithDOASEquipmentType)
Value: "DOAS with VRF"

An enumeration.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "VRFwithDOAS",
  • "vintage": "90.1-2013",
  • "sensible_heat_recovery":
    {
    },
  • "latent_heat_recovery":
    {
    },
  • "equipment_type": "DOAS with VRF"
}

VRFwithDOASEquipmentType

string (VRFwithDOASEquipmentType)
Value: "DOAS with VRF"

An enumeration.

"DOAS with VRF"

WallConstructionSet

object (Interior Construction)

An OpaqueConstruction for walls with a Surface or Adiabatic boundary condition.

object (Exterior Construction)

An OpaqueConstruction for walls with an Outdoors boundary condition.

object (Ground Construction)

An OpaqueConstruction for walls with a Ground boundary condition.

type
string (Type) ^WallConstructionSet$
Default: "WallConstructionSet"
{
  • "interior_construction":
    {
    },
  • "exterior_construction":
    {
    },
  • "ground_construction":
    {
    },
  • "type": "WallConstructionSet"
}

WallConstructionSetAbridged

interior_construction
string (Interior Construction) [ 1 .. 100 ] characters

Identifier for an OpaqueConstruction for faces with a Surface or Adiabatic boundary condition.

exterior_construction
string (Exterior Construction) [ 1 .. 100 ] characters

Identifier for an OpaqueConstruction for faces with an Outdoors boundary condition.

ground_construction
string (Ground Construction) [ 1 .. 100 ] characters

Identifier for an OpaqueConstruction for faces with a Ground boundary condition.

type
string ^_FaceSubSetAbridged$
Default: "_FaceSubSetAbridged"
{
  • "interior_construction": "string",
  • "exterior_construction": "string",
  • "ground_construction": "string",
  • "type": "WallConstructionSetAbridged"
}

WallModifierSet

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Exterior Modifier)

A radiance modifier object for faces with an Outdoors boundary condition.

Plastic (object) or Glass (object) or BSDF (object) or Glow (object) or Light (object) or Trans (object) or Metal (object) or Void (object) or Mirror (object) (Interior Modifier)

A radiance modifier object for faces with a boundary condition other than Outdoors.

type
string (Type) ^WallModifierSet$
Default: "WallModifierSet"
{
  • "exterior_modifier":
    {
    },
  • "interior_modifier":
    {
    },
  • "type": "WallModifierSet"
}

WallModifierSetAbridged

exterior_modifier
string (Exterior Modifier)

Identifier for a radiance modifier object for faces with an Outdoors boundary condition.

interior_modifier
string (Interior Modifier)

Identifier for a radiance modifier object for faces with a boundary condition other than Outdoors.

type
string ^BaseModifierSetAbridged$
Default: "BaseModifierSetAbridged"
{
  • "exterior_modifier": "string",
  • "interior_modifier": "string",
  • "type": "WallModifierSetAbridged"
}

WindowAC

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
vintage
string (Vintages)
Enum: "90.1-2013" "90.1-2010" "90.1-2007" "90.1-2004" "DOE Ref 1980-2004" "DOE Ref Pre-1980"

An enumeration.

equipment_type
string (WindowACEquipmentType)
Enum: "Window AC with baseboard electric" "Window AC with baseboard gas boiler" "Window AC with baseboard central air source heat pump" "Window AC with baseboard district hot water" "Window AC with forced air furnace" "Window AC with unit heaters" "Window AC with no heat"

An enumeration.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "WindowAC",
  • "vintage": "90.1-2013",
  • "equipment_type": "Window AC with baseboard electric"
}

WindowACEquipmentType

string (WindowACEquipmentType)
Enum: "Window AC with baseboard electric" "Window AC with baseboard gas boiler" "Window AC with baseboard central air source heat pump" "Window AC with baseboard district hot water" "Window AC with forced air furnace" "Window AC with unit heaters" "Window AC with no heat"

An enumeration.

"Window AC with baseboard electric"

WindowConstruction

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
layers
required
Array of strings (Layers) [ 1 .. 8 ] items

List of strings for glazing or gas material identifiers. The order of the materials is from exterior to interior. If a SimpleGlazSys material is used, it must be the only material in the construction. For multi-layered constructions, adjacent glass layers must be separated by one and only one gas layer.

required
Array of EnergyWindowMaterialSimpleGlazSys (object) or EnergyWindowMaterialGlazing (object) or EnergyWindowMaterialGas (object) or EnergyWindowMaterialGasCustom (object) or EnergyWindowMaterialGasMixture (object) (Materials) [ 1 .. 8 ] items

List of glazing and gas materials. The order of the materials is from outside to inside. If a SimpleGlazSys material is used, it must be the only material in the construction. For multi-layered constructions, adjacent glass layers must be separated by one and only one gas layer.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "WindowConstruction",
  • "layers":
    [
    ],
  • "materials":
    [
    ]
}

WindowConstructionAbridged

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
layers
required
Array of strings (Layers) [ 1 .. 8 ] items

List of strings for glazing or gas material identifiers. The order of the materials is from exterior to interior. If a SimpleGlazSys material is used, it must be the only material in the construction. For multi-layered constructions, adjacent glass layers must be separated by one and only one gas layer.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "WindowConstructionAbridged",
  • "layers":
    [
    ]
}

WindowConstructionShade

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
window_construction
required
object (Window Construction) Recursive

A WindowConstruction object that serves as the "switched off" version of the construction (aka. the "bare construction"). The shade_material and shade_location will be used to modify this starting construction.

required
EnergyWindowMaterialShade (object) or EnergyWindowMaterialBlind (object) or EnergyWindowMaterialGlazing (object) (Shade Material)

Identifier of a An EnergyWindowMaterialShade or an EnergyWindowMaterialBlind that serves as the shading layer for this construction. This can also be an EnergyWindowMaterialGlazing, which will indicate that the WindowConstruction has a dynamically-controlled glass pane like an electrochromic window assembly.

shade_location
string (ShadeLocation)
Enum: "Interior" "Between" "Exterior"

Choices for where a shade material is located in a window assembly.

control_type
string (ControlType)
Enum: "AlwaysOn" "OnIfHighSolarOnWindow" "OnIfHighHorizontalSolar" "OnIfHighOutdoorAirTemperature" "OnIfHighZoneAirTemperature" "OnIfHighZoneCooling" "OnNightIfLowOutdoorTempAndOffDay" "OnNightIfLowInsideTempAndOffDay" "OnNightIfHeatingAndOffDay"

Choices for how the shading device is controlled.

setpoint
number <double> (Setpoint)

A number that corresponds to the specified control_type. This can be a value in (W/m2), (C) or (W) depending upon the control type.Note that this value cannot be None for any control type except "AlwaysOn."

ScheduleRuleset (object) or ScheduleFixedInterval (object) (Schedule)

An optional ScheduleRuleset or ScheduleFixedInterval to be applied on top of the control_type. If None, the control_type will govern all behavior of the construction.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "WindowConstructionShade",
  • "window_construction":
    {
    },
  • "shade_material":
    {
    },
  • "shade_location": "Interior",
  • "control_type": "AlwaysOn",
  • "setpoint": 0,
  • "schedule":
    {
    }
}

WindowConstructionShadeAbridged

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
window_construction
required
object (Window Construction) Recursive

A WindowConstructionAbridged object that serves as the "switched off" version of the construction (aka. the "bare construction"). The shade_material and shade_location will be used to modify this starting construction.

shade_material
required
string (Shade Material) [ 1 .. 100 ] characters

Identifier of a An EnergyWindowMaterialShade or an EnergyWindowMaterialBlind that serves as the shading layer for this construction. This can also be an EnergyWindowMaterialGlazing, which will indicate that the WindowConstruction has a dynamically-controlled glass pane like an electrochromic window assembly.

shade_location
string (ShadeLocation)
Enum: "Interior" "Between" "Exterior"

Choices for where a shade material is located in a window assembly.

control_type
string (ControlType)
Enum: "AlwaysOn" "OnIfHighSolarOnWindow" "OnIfHighHorizontalSolar" "OnIfHighOutdoorAirTemperature" "OnIfHighZoneAirTemperature" "OnIfHighZoneCooling" "OnNightIfLowOutdoorTempAndOffDay" "OnNightIfLowInsideTempAndOffDay" "OnNightIfHeatingAndOffDay"

Choices for how the shading device is controlled.

setpoint
number <double> (Setpoint)

A number that corresponds to the specified control_type. This can be a value in (W/m2), (C) or (W) depending upon the control type.Note that this value cannot be None for any control type except "AlwaysOn."

schedule
string (Schedule) [ 1 .. 100 ] characters

An optional schedule identifier to be applied on top of the control_type. If None, the control_type will govern all behavior of the construction.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "WindowConstructionShadeAbridged",
  • "window_construction":
    {
    },
  • "shade_material": "string",
  • "shade_location": "Interior",
  • "control_type": "AlwaysOn",
  • "setpoint": 0,
  • "schedule": "string"
}

WSHP

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
vintage
string (Vintages)
Enum: "90.1-2013" "90.1-2010" "90.1-2007" "90.1-2004" "DOE Ref 1980-2004" "DOE Ref Pre-1980"

An enumeration.

equipment_type
string (WSHPEquipmentType)
Enum: "Water source heat pumps fluid cooler with boiler" "Water source heat pumps cooling tower with boiler" "Water source heat pumps with ground source heat pump" "Water source heat pumps district chilled water with district hot water"

An enumeration.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "WSHP",
  • "vintage": "90.1-2013",
  • "equipment_type": "Water source heat pumps fluid cooler with boiler"
}

WSHPEquipmentType

string (WSHPEquipmentType)
Enum: "Water source heat pumps fluid cooler with boiler" "Water source heat pumps cooling tower with boiler" "Water source heat pumps with ground source heat pump" "Water source heat pumps district chilled water with district hot water"

An enumeration.

"Water source heat pumps fluid cooler with boiler"

WSHPwithDOAS

identifier
required
string (Identifier) [ 1 .. 100 ] characters

Text string for a unique object ID. This identifier remains constant as the object is mutated, copied, and serialized to different formats (eg. dict, idf, osm). This identifier is also used to reference the object across a Model. It must be < 100 characters, use only ASCII characters and exclude (, ; ! \n \t).

display_name
string (Display Name)

Display name of the object with no character restrictions.

type
string ^IDdEnergyBaseModel$
Default: "IDdEnergyBaseModel"
vintage
string (Vintages)
Enum: "90.1-2013" "90.1-2010" "90.1-2007" "90.1-2004" "DOE Ref 1980-2004" "DOE Ref Pre-1980"

An enumeration.

Autosize (object) or number (Sensible Heat Recovery)
Default: {"type":"Autosize"}

A number between 0 and 1 for the effectiveness of sensible heat recovery within the system. If None or Autosize, it will be whatever is recommended for the given vintage.

Autosize (object) or number (Latent Heat Recovery)
Default: {"type":"Autosize"}

A number between 0 and 1 for the effectiveness of latent heat recovery within the system. If None or Autosize, it will be whatever is recommended for the given vintage.

equipment_type
string (WSHPwithDOASEquipmentType)
Enum: "DOAS with water source heat pumps fluid cooler with boiler" "DOAS with water source heat pumps cooling tower with boiler" "DOAS with water source heat pumps with ground source heat pump" "DOAS with water source heat pumps district chilled water with district hot water"

An enumeration.

{
  • "identifier": "string",
  • "display_name": "string",
  • "type": "WSHPwithDOAS",
  • "vintage": "90.1-2013",
  • "sensible_heat_recovery":
    {
    },
  • "latent_heat_recovery":
    {
    },
  • "equipment_type": "DOAS with water source heat pumps fluid cooler with boiler"
}

WSHPwithDOASEquipmentType

string (WSHPwithDOASEquipmentType)
Enum: "DOAS with water source heat pumps fluid cooler with boiler" "DOAS with water source heat pumps cooling tower with boiler" "DOAS with water source heat pumps with ground source heat pump" "DOAS with water source heat pumps district chilled water with district hot water"

An enumeration.

"DOAS with water source heat pumps fluid cooler with boiler"